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Preface 


The complete XENIX Reference Manual is actually divided into six parts and 
distributed as individual reference sections in the various volumes of the XENIX 
Timesharing, Text Processing, and Software Development Systems. The 
following table lists the name, content, and location of each reference section. 


Section Description Volume 


C Commands — used with the XENIX XENIX Reference Manual 
Timesharing System. 


CT Text Processing Commands — used Text Processing Guide 
with the Text Processing System. 


CP Programming Commands-—used with Programmer’s Guide 
the Software Development System. 


M Miscellaneous — information used for XENIX Reference Manual 
access to devices, system 
maintenance, and communications. 


S System Calls and Library Routines— Library Guide 
available for CC and _ assembly 
language programming. 


F File Formats — description of various Library Guide 
system files not defined in section M. 


In text, a given command, routine, or file is referred to by name and section. 
For example, the programming command ‘‘cc’’, which is described in the 
Programming Commands (CP) section, is listed as e¢(CP) in the text. 


The alphabetized table of contents given on the following pages is a complete 
listing of all XENIX commands, system calls, library routines, and file formats. 
If you want to locate information about a specific item look in the indicated 
reference section. 
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Name 


intro — Introduces XENIX commands. 


YY Description 
This section describes use of the individual commands available in 


the XENIX Timesharing System. Unless otherwise noted, commands 
described in this section accept options and other arguments accord- 
ing to the following syntax: 


name | option(s)] [cmdarg(s)] 


where: 

name Is the name of an executable file. 

option — noargletter(s) or, 
— argletter<>optarg 
where <> is optional whitespace. 

noargletter Is a single letter representing an option without an 
argument. 

argletter Is a single letter representing an option requiring an 
argument. 

optarg Is an argument (character string) satisfying preceding 
argletter. 

emdarg Is a pathname (or other command argument) not 
beginning with — . — by itself indicates the standard 
input. 

See Also 


getopt{C), getopt(S) 
Diagnostics 


Upon termination, each command returns 2 bytes of status, one sup- 
plied by the system and giving the cause for termination, and (in the 
a case of ‘‘normal’’ termination) one supplied by the program (see 
wait(S) and ezit(S)). The former byte is 0 for normal termination; 
the latter is customarily 0 for successful execution and nonzero to 
indicate troubles such as erroneous parameters, bad or inaccessible 
data. It is called variously ‘‘exit code’’, ‘‘exit status’’, or ‘‘return 
code’’, and is described only where special conventions are involved. 
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Notes 


Not all commands adhere to the syntax described here. 
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Name 


acctcom — Searches for and prints process accounting files. 


Syntax 


acctcom [[options][file]] ... 


Description 


Acctcom reads file, the standard input, or /usr/adm/pacct, in the 
form described by acct(F) and writes selected records to the standard 
output. Each record represents the execution of one process. The 
output shows the COMMAND NAME, USER, TTYNAME, START 
TIME, END TIME, REAL (SEC), CPU (SEC), MEAN SIZE(K), and 
optionally, F (the fork /ezec flag: 1 for fork without ezec) and STAT 
(the system exit status). 


The command name is prepended with a # if it was executed with 
super-user privileges. If a process is not associated with a known 
terminal, a? is printed in the TTYNAME field. 


If no files are specified, and if the standard input 1s associated with a 
terminal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read, otherwise the standard input is read. 


If any file arguments are given, they are read in their respective 
order. Each file is normally read forward, i.e., in chronological order 
by process completion time. The file /usr/adm/pacct is usually the 
current file to be examined; a busy system may need several files, in 
which case all but the current file will be found in /usr/adm/pacct?. 
The options are: 


—b Reads backwards, showing latest commands first. 


—f Prints the fork /ezec flag and system exit status columns 
in the output. 


—h Instead of mean memory size, shows the fraction of total 
available CPU time consumed by the process during its 


execution. This ‘‘hog factor’’ is computed as: 


(total CPU time) /(elapsed time). 


v& — 1 Prints columns containing the I/O ccunts in the output. 


— k Instead of memory size, shows total kcore-minutes. 


—m Shows mean core size (the default). 
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—r Shows CPU factor (user time/(system-time +  user- 
time).) 

—t Shows separate system and user CPU times. 

—v Excludes column headings from the output. 


— Il line Shows only processes belonging to terminal /dev/line. 


—u user Shows only processes belonging to user that may be 
specified by a user ID, a login name that is then converted 
to a user ID, a # which designates only those processes 
executed with super-user privileges, or ? which designates 
only those processes associated with unknown user IDs. 


— g group Shows only processes belonging to group. The group may 
be designated by either the group ID or group name. 


— d mm/dd 
Any time arguments following this flag are assumed to 
occur on the given month and day, rather than during the 
last 24 hours. This is needed for looking at old files. 


—s time Shows only those processes that existed on or after time, 
given in the form Ar:min:sec. The :sec or :min:sec may 
be omitted. 


—e time Shows only those processes that existed on or before 
time. Using the same time for both — s and — e shows 
the processes that existed at time. 


n pattern 
Shows only commands matching pattern that may be a 
regular expression as in ed(C) except that + means one 
or more occurrences. 


— H factor 
Shows only processes that exceed factor, where factor is 
the ‘‘hog factor’’ as explained in option — h above. 


— O time Shows only those processes with operating system CPU 
time that exceeds time. 


— C time Shows only those processes that exceed time (the total 
CPU time). 


Multiple options have the effect of a logical AND. Aa 
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Files 
/etc/passwd 
/usr/adm /pacct 


/etc/group 


See Also 


accton(C), ps(C), su(C), acct(S), acct(F), utmp(M) 


Notes 


Acctcom only reports on processes that have terminated; use ps(C) 
for active processes. 
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Name 
accton — Turns on accounting. 

Syntax ‘fy 
accton | file] 

Description 


Accton turns on and off process accounting. If no file is given, then 
accounting is turned off. If fle is given, it must be the name of an 
existing file, to which the kernel appends process accounting records. 


(see acct(S) and acct(F)). 


Files 
/etc/passwd Used for login name to user ID conversions 
/usr/lib/acct Holds many accounting commands 


/usr/adm/pacct Current process accounting file 


/usr/adm/wtmp _Login/logout history file ‘> 


See Also 


acctcom(C), acct(S), acct(F), utmp(M) 
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Name 


asktime — Prompts for the correct time of day. 


Syntax 


/etc/asktime 


Description 


This command prompts for the time of day. You must enter a legal 
time according to the proper format as defined below: 


[ yymmdd] hhmm 
Here the first mm is the month number; dd is the day number in the 
month; AA is the hour number (24-hour system); the second mm is 


the minute number; yy is the last 2 digits of the year number and is 
optional. The current year is the default if no year is mentioned. 


Examples 


1984’’. 


Y This example sets the new time, date, and year to ‘'11:29 April 20, 


I think it’s Wed Nov 3 14:36:23 PST 1982 
Enter time ([yymmdd]hhmm): 8404201129 


Diagnostics 
If you enter an illegal time, asktsme prompts with: 


Try again: 


Notes 


Asktime is normally performed automatically by the system startup 
file /etc/rc immediately after the system is booted; however, it may 
be executed at any time. The command is privileged, and can only 


& be executed by the super-user. 
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Name 


assign, deassign — Assigns and deassigns devices. 


t oY 
assign [— u] [— v] [-—d] [ device ] ... 


deassign [ — u] [ — v] [ device ] ... 


Description 


Assign attempts to assign device to the current user. The device argu- 
ment must be an assignable device that is not currently assigned. 
An assign command without an argument prints a list of assignable 
devices along with the name of the user to whom they are assigned. 


Deassign is used to ‘‘deassign’’ devices. Without any arguments, 
deassign will deassign all devices assigned to the user. When argu- 
ments are given, an attempt is made to deassign each device given as 
an argument. 


Assign and deasstgn may only be invoked when logged in as the 
super-user. 


Available options include: 


—d Performs the action of deassign. The — d option causes all dev- 
ices whose names appear after the option to be deassigned. 


— v Gives verbose output. 


— u Suppresses assignment or deassignment, but performs error 
checking. 


The asstgn command will not assign any assignable devices if it can- 
not assign all of them. Deasstgn gives no diagnostic if the device can- 
not be deassigned. Devices may be automatically deassigned at 
logout, but this is not guaranteed. Device names may be just the 
beginning of the device required. For example, 


assign fd 


should be used to assign all floppy disk devices. Raw versions of 
device will also be assigned, e.g., the raw floppy disk devices 


/dev/rfd? would be assigned in the above example. 


Note that in many installations the assignable devices such as floppy 
disks have general read and write access, so the assign command 
may not be necessary. This is particularly true on one-user systems. 
Devices supposed to be assignable with this command should be 
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owned by the user asg. The directory /de« should be owned by bin 
and have mode 755. The assign command (after checking for use by 
someone else) will then make the device owned by whoever invokes 
the command, without changing the access permissions. This allows 
the system administrator to set up individual devices that are freely 


available, assignable (owned by agg), or nonassignable and restricted 
\& (not owned by asg and with some restricted mode). 
Note also that the first time assign is invoked it builds the assignable 
devices table fetc/atab. This table is used in subsequent invocations 
to save repeated searches of the /dev directory. If one of the devices 
in /dev is changed to be assignable (i.e., owned by asg), then /etc/atab 


should be removed (by the super-user) so that a correct list will be 
built the next time the command is invoked. 


Files 


Exit code 0 returned if successful, 1 if problems, 2 if device cannot 
be assigned. 
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Name 


at, atg, atrm — Executes commands at a later time. 


Syntax 
at time { day| [ file | 


atq[-1] 


atrm idnumber... 


Description 


At causes the contents of a file to be executed as a shell script at a 
specified time. This command is useful for running processes at reg- 
ular intervals, or when the system is not busy. The arguments are: 


time 1 to 4 digits, followed by an optional ‘‘a’ for am, “‘ 


p’’ for 
pm, ‘‘n’’ for noon, or ‘‘m’’ for midnight. One- and two- 
digit numbers are interpreted as hours, three- and four-digit 
numbers as hours and minutes. If no letters follow the 


digits, 24-hour time is assumed. 


day Either a month name followed by a day number, or the 
name of a day of the week. If the word ‘‘week’’ follows the 
name of the day, the file is invoked seven days after the day 
named. Names of months and days may be recognizably 
truncated. (See the Examples later in this section.) 


file The name of the file containing the command(s) to be exe- 
cuted. If no file is specified, the standard input is assumed. 


At creates a file that is executed by the shell at the specified time. 
This file contains a comment line that lists the user’s user ID and 
group ID, a cd command that changes the working directory of the 
process to the one you were using when you executed at, assign- 
ments to the appropriate environment variables, and the file specified 
in the at command line. Output from processes in fle must be 
redirected or, (on most systems) itis lost. Atshell scripts are run by 
periodic execution of the command /usrfib/atrun from cron(C). 


The atg command gives the following information about files waiting 
to be processed: 


— The user ID under which the file will run 
— A unique ID number used to reference the file 


- The date and time the file will be processed 
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The -!/ option displays the commands in each file in the queue. 

The atrm command removes files from the ‘‘at’’ queue. Atrm uses 
the ID number{s) from the atg command to remove the specific 
file(s). A user can only remove his own files. 


Examples 


Use the following line to place a file in the queue: 


at 8a jan 24 file 


In the following command line, file will be executed a week from 
this Friday at 3:30 pm. 


at 1530 fr week file 

To remove a file from the queue, find out the ID number(s) with 
atq 

Then remove the file with atrm : 
atrm tdnumber 


A sample at file might contain the line 


lpr biglongflle 


which sends biglongfile to the lineprinter. 


Files 


/usr/spool/at/yy.ddd.hhhh.uu 
Activity to be performed at hour hhhh of 
day ddd of year yy Uu is a unique 
num ber. 


/usr/spoo) /at/lasttimedone 
Contains hhhA for last hour of activity. 


/usr/spool/at/past Contains old at files. 


/usr/lib/atrun Program that executes activities at the 
specified time. 


See Also 


calendar(C), cron(C), pwd(C) 
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Diagnostics 


Complains about various syntax errors and times out of range. 


Notes 


The directory /usr/spool/at/past should be periodically emptied by the ry 


super-user. 


Due to the granularity of the execution of fusrAib/atrun, there may be 
problems in scheduling things exactly 24 hours into the future. 
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Name 


awk - Searches for and processes a pattern in a file. 


Syntax 


awk [— Fe] [ - f programfile |’ program’ | [ file... | 


Description 
Awk scans each input file for lines that match patterns specified in 
program or in programfile. When a line of file matches a pattern, an 
associated action may be performed. Awk is useful for compiling 
information, performing arithmetic on input data, and for doing 
iterative or conditional processing. 


The options are: 


— Fe Sets the field separator variable (FS) to the letter ‘‘c’’. The 
default field separators are tab and space. 


—f Causes awk to take its program from programfile. 
The arguments are: 


programfile 
A file containing an awk program. 


program An awk program. Programs given on the command line 
must be enclosed in single quotation marks to prevent 
interpretation by the shell. 


fides. The name(s) of the file or files to be processed. If no 
filename is given, the standard output is used. 


An awk program consists of statements in the form: 
pattern { action } 


Pattern-action statements may appear on the awk command line, or 
in an awk program file. 


If no pattern is given, all lines in the input file are matched. If no 


© actton is given, each matched line is displayed on the standard out 
put. 


A pattern may be a literal string or a regular expression, or a combi- 
nation of a regular expression and a field or variable separated by 
operators. 
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Awk also provides two patterns, BEGIN and END, that can be used to 
perform actions before the first line is read, and after the last line is 
read, respectively. 


To select a range of lines, use two patterns on a single program line, 
separated by a comma. 


An action is a sequence of statements separated by a semicolon, 
newline, or right brace. See Statements later in this section. 


Vanables 


In addition to variables declared and initialized by the user, awk has 
the following program variables: 


NR Number of records. 

NF Number of fields in a record. 

FS Input field separator. 

OFS Output field separator. 

RS Input record separator. 

ORS Output record separator. 

$0 The current record. 

$1, $n Fields in the current record. 

OFM The ouput format for numbers. The default is 26g. 
FILENAME 


The name of the input file currently being read. 
Arrays may be used to store data. Arrays do not need to be dimen- 
sioned before use. For example, w{i] denotes the ith item of array w. 
Ezpressions 


A pattern match with a field or variable may be tested with the fol- 
lowing operators: 


~ Matches the regular expression. ‘> 
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YY 


AWK (C) 


!~ Does not match the regular expression. 


AWK (C) 


Awk processes relational expressions using the following operators: 


Cel 


> 


Less than 

Less than or equal to 
Equal to 

Not equal to 

Greater than or equal to 


Greater than 


Patterns can be combined using the operators: 


& & 


And 


Not 


An empty expression-list stands for the whole line. Expressions take 
on string or numeric values as appropriate, and are built using the 
following operators: 


a 


Addition 
Subtraction 
Multiplication 
Division 


Modulo 


Concatenation is indicated by a blank. 


The following C operators are also available in expressions: 


a4 


Increment 
Decrement 

Add and assign 
Subtract and assign 


Multiply and assign 
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|= Divide and assign 


Ge Modulo and assign 


Statements ry 
if ( conditional ) statement [ else statement | 


while ( conditional ) statement 
for { expression ; conditional ; expression ) statement 


break 

continue 

{ [| statement ] ... } 
variable = expression 


print [| ezpresston-list | [| > expression | 
printf format [ , ezpression-list | [ >ezpression | 
next #skip remaining patterns on input line 


while Used the same as in C. 


for The iterative construction. It can be used the same as in 
the C language, or as an array iterator. 


break Similar to its C counterpart. 


continue Similar to its C counterpart. 


print Prints its arguments on the standard output, or in a file if 
redirected. 

printf Prints ezpression-list in the format specified in format. See 
printf(S). 

next Stops processing the current record and moves to the next 


record, if any. 


Comments are preceded by a number sign ( #). 


Functions 
Awk has the following built-in functions: 


exit(z) Terminates the awk program. If z is given, this value is 
awk’s return value. If z is not given, 0 is returned. If the 
program has an END section, it is invoked before termina- 
tion. 


exp(z) Exponentiation of the value of z. 


index(s, t) 
Returns the starting position of the leftmost occurrence of t 
in s. If tis not a substring of s, then index(as, t) is 0. 
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int(z) Returns the largest integer less than or equal to gz. If z is 
negative, its value is the smallest integer greater than or 


equal to z. 

length(z) 
A function whose value is the number of characters in the 
string (z). With no arguments length is equivalent to $0. 


log(z) Natural logarithm of z. 


split(z, y) 
Assigns the fields of string z to successive elements of array 
y. 

sqrt{(z) Square root of z. 

substr( string, indez, length) 


Returns the substring of string that begins at tndez and is 
length characters long. 


Examples 
The following displays lines in file longer than 72 characters: 
awk {length > 72} file 
we The following prints the first two fields in opposite order: 


awk ’{ print $2, $1 } file 


The following adds up the first columns and prints their sum and 
average: 


{s += $1 } 
END { print "sum is”, s, ” average is”, s/NR } 


The following prints the fields in file in reverse order: 
awk { for (i = NF; i > 0; — -i) print $i } file 


The following awk program file will print all lines in the object file 
whose first field is different from the first field in the previous line: 


$1 != prev { print; prev = $1 } 


os See Also 


grep(C), lex(CP), sed(C) 
The XENIX Tezt Processing Gutde 
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Notes 
Input whitespace is not preserved on output if fields are involved. 
There are no explicit conversions between numbers and strings. To 


force an expression to be treated as a number add 0 to it; to force it 
to be treated as a string concatenate the null string (””) to it. 


This command is more fully documented in the XENIX Tezt Process- 
ing Guide. 
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Name 


banner — Prints large letters. 


Syntax 


banner strings 


Description 


Banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. This is useful for printing names at 
the front of printouts. 
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Name 


basename — Removes directory names from pathnames. 


Syntax 


basename string | suffix ] fy 


Description 


Basename deletes any prefix ending in / and the suffiz (if present in 
string) from string, and prints the result on the standard output. The 
result is the ‘‘base’’ name of the file, 1.e., the filename without any 
preceding directory path and without an extension. It is used inside 
substitution marks (**) in shell procedures to construct new 
filenames. 


The related command dirname deletes the last level from string and 
prints the resulting path on the standard output. 
Examples 


The following command displays the filename memos on the stan- 
dard output: 


basename /usr/johnh/memos.old .old 
The following shell procedure, when invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the output 
to a file named cat in the current directory: 

cc $1 

mv a.out ‘basename $1 .c* 


See Also 


dirname(C), sh(C) 
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Name 


bce — Invokes a calculator. 


Syntax 


bebe eto Fa tite)- | 


Description 


Be is an interactive processor for a language that resembles C but 
provides iinlimited precision arithmetic. It takes input from any files 
given, then reads the standard input. The — | argument stands for 
the name of an arbitrary precision math library. The syntax for bce 
programs is as follows: L means the letters a~ z, E means expres- 
sion, S means statement. 


Comments: 
Enclosed in /* and */ 
Names: 
Sim ple variables: L 
Array elements: L [ E ] 


The words ‘‘ibase’’, ‘‘obase’’, and ‘‘scale’’ 


Other operands: 


Arbitrarily long numbers with optional sign and decimal point 


(E) 

sqrt ( E ) 

length ( E ) Number of significant decimal digits 
scale { E ) Number of digits right of decimal point 
Bie... oe) 


Additive operators: 


+ 


Multiplicative operators: 


* 


% (remainder) 
* (exponentiation) 
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Unary operators: 


ew 
x (prefix and postfix; apply to names) 


Relational operators: 


Assignment operators: 


I i td del 
eS i a + 


Statements: 


null statement 
break 
quit 


Function definitions: 


define 1, ( EB... ARs 
SGA cs gy 
a 
return ( E ) 
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Functions in — | math library: 


s(x) Sine 
c( x) Cosine 
e(x) Exponential 


I(x) Log 
a(x) Arctangent 
j(n,x} ‘Bessel function 


All function arguments are passed by value. 


The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or newlines may 
separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of 
de(C). Assignments to tbase or obase set the input and output 
number radix respectively. 


The same letter may be used as an array, a function, and a simple 
variable simultaneously. All variables are global to the program. 
‘“‘Auto’’ variables are pushed down during function calls. When 
using arrays as function arguments or defining them as automatic 
variables, empty square brackets must follow the array name. 


Be is actually a preprocessor for de(C), which it invokes automati- 
cally, unless the — c (compile only) option is present. If the —c 


& option is present, the dc input is sent to the standard output instead. 


Example 


The following defines a function to compute an approximate value of 
the exponential function: 


scale = 20 


define e(x){ 


auto a, b, ¢, 1, 8 
a=! 
b = 1 
s == |] 
for(i=1; 1==—1; i+ +) { 
a =a ars 
b =a D7; 
c = a/b 
if(c == 0) return(s) 


} 
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The following prints the approximate values of the exponential func- 
tion of the first ten integers: 


for(i=1; i<==10; i+ +) e(i) 
Files 


/usr/lib/lib.bc Mathematical library ry 


/Jusr/bin/de Desk calculator proper 


See Also 
de(C) 
The XENIX User’s Guide 
Notes 
A For statement must have all three E’s. 


Qutt is interpreted when read, not when executed. 
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Name 


bdiff - Compares files too large for dif. 


Syntax 


bdiff file1 file? { n] [- s] 


Description 


Baff finds compares two files, finds lines that are different, and 
prints them on the standard output. It allows processing of files that 
are too large for diff. Bdiff splits each file into n-line segments, 
beginning with the first nonmatching lines, and invokes dtff upon the 
corresponding segments. The arguments are: 


n The number of lines bdtff splits each file into for processing. The 
default value is 3500. This is useful when 3500-line segments 
are too large for diff. 


—s Suppresses printing of bdiff diagnostics. Note that this does not 
suppress printing of diagnostics from df 


& If filet (orfile2) is a dash (— ), the standard input is read. 


The output of bdtff is exactly that of diff. Line numbers are adjusted 
to account for the segmenting of the files, and the output looks as if 
the files had been processed whole. 


Files 


See Also 


diff(C) 


Notes 


Because of the segmenting of the files, bdiff does not necessarily find 


& a smallest sufficient set of file differences. 
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Name 


bfs — Scans big files. 


Syntax 


bfs [— ] name 


Description 


Bfs is like ed(C) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes and 32K lines, with up 
to 255 characters per line. fs is usually more efficient than ed for 
scanning a file, since the file is not copied to a buffer. It is most 
useful for identifying sections of a large file where ceplit(C) can be 
used to divide it into more manageable pieces for editing. 


Normally, the size of the file being scanned is printed, as is the size 
of any file written with the w command. The optional dash (— ) 
suppresses printing of sizes. Input is prompted for with an asterisk 
(*) by default. If a ‘‘P’’ and a RETURN are typed as in ed, then 
prompting is turned off. The ‘‘P’’ acts as a toggle, so prompting can 
be turned on again by entering another ‘‘P’’ and a RETURN. Note 
that messages are given in response to errors only if prompting is 
turned on. 


All address expressions described under ed are supported. In addi- 
tion, regular expressions may be surrounded with two symbols other 
than the standard slash (/) and (?): A greater-than sign (>) indi- 
cates downward search without wraparound, and a less-than sign 
(<) indicates upward search without wraparound. Since bfe uses a 
different regular expression-matching routine from ed, the regular 
expressions accepted are slightly wider in scope (see regex(S)). The 
differences from ed syntax include the fact that parentheses and 
curly braces are special and need not be escaped. Differences are 
listed below: 


+ A regular expression followed by + means one or more 
times. For example, [O0-9]+ is equivalent to 
[O— 9][G— 9]*. 


{m} {m,} {m,u} 

Integer values enclosed in {} indicate the number of times 
the preceding regular expression is to be applied. m is the 
minimum number and uw is a number, less than 256, which 
is the maximum. If only m is present (e.g., {m}), it indi- 
cates the exact number of times the regular expression is 
to be applied. {m,} is analogous to {m,infinity}. The plus 
(+) and star (*) operations are equivalent to {1,} and {0,} 
respectively. 
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(...)$n The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n+ 1)th argu- 
ment following the subject argument. At most ten 
enclosed regular expressions are allowed. Regez makes its 
assignments unconditionally. 


& (...) Parentheses are used for grouping. An operator, e.g. *, 


+, {}, can work on a single character or a regular expres- 
sion enclosed in parenthesis. For example, (a*(cb+ )*)$0. 


There is also a slight difference in mark names: only the letters ‘‘a’’ 


through ‘‘z’’ may be used, and all 26 marks are remembered. 


The e, g, v, k, n, p, q, w, =, ! and null commands operate as 
described under ed. Commands such as ---, +++-, +++=, 
— 12, and + 4p are accepted. Note that 1,10p and 1,10 will both 
print the first ten lines. The f command only prints the name of the 
file being scanned; there is no remembered filename. The w com- 
mand is independent of output diversion, truncation, or crunching 
(see the xo, xt and xc commands, below). The following additional 
commands are available: 


xf file 
Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received, or an 
error occurs, reading resumes with the file containing the xf. 
Xf commands may be nested to a depth of 10. 


xo [ file] 
Further output from the p and null commands is diverted to 
the named file. If file is missing, output is diverted to the stan- 
dard output. Note that each diversion causes truncation or 
creation of the file. 


: label 
This positions a label in a command file. The label is ter- 
minated by a newline, and blanks between the : and the start 
of the label are ignored. This command may also be used to 
insert comments into a command file, since labels need not be 
referenced. 


(., .)xb/regular erpression/label 
A jump (either upward or downward) is made to label if the 
command succeeds. It fails under any of the following condi- 
tions: 


& 1. Either address is not between 1 and §. 


2. The second address is less than the first. 


3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 
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On success, dot (.) is set to the line matched and a Jump is 
made to label. This command is the only one that doesn’t issue 
an error message on bad addresses, so it may be used to test 
whether addresses are bad before other commands are exe- 
cuted. Note that the command 


xb/*/ label 


is an unconditional jump. 


The xb command is allowed only if it is read from somewhere 
other than a terminal. If it is read from a pipe only a down- 
ward jump is possible. 


xt number 
Output from the p and null commands is truncated to a max- 
imum of number characters. The initial number is 255. 


xv digit] [ spaces] | value] 
The variable name is the specified digit following the xv. 
Xv5100 or xv5 100 both assign the value 100 to the variable 5. 
Xv61,100p assigns the value 1,100p to the variable 6. To refer- 
ence a variable, put a %in front of the variable name. For 
example, using the above assignments for variables 5 and 8: 


1,%5p 
1,% 
TB 


prints the first 100 lines. 


g/%5/p 


globally searches for the characters 100 and prints each line 
containing a match. To escape the special meaning of %a\ 
must precede it. For example, 


g/”.*\74 cds] /p 


could be used to match and list lines containing printf charac- 
ters, decimal integers, or strings. 


Another feature of the xv command is that the first line of 
output from a XENIX command can be stored into a variable. 
The only requirement is that the first character of value be a!. 
For example, 


xvo!cat junk ‘> 


'rm junk 
techo "%5” 
xv6!lexpr %6 + 1 
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puts the current line in variable 5, prints it, and increments the 
variable 6 by one. To escape the special meaning of ! as the 
first character of value, precede it with a \. For example, 


xv7\!date 
& stores the value !date into variable 7. 
xbz label 
xbn label 


These two commands test the last saved return code from the 
execution of a XENIX command (!command) or nonzero value, 
respectively, and jump to the specified label. The two exam- 
ples below search for the next five lines containing the string 
size: 


XVOO 


a 

/size/ 

xvolexpr %5 — 1 
lif 0%5 != 0 exit 2 
xbn | 


xv45 


24 
Y /size/ 
xv4texpr %A- 1 


lif O%4 = 0 exit 2 
xbz | 


xc [ switch] 
If switch is 1, output from the p and null commands is 
crunched; if switch is 0 it isn’t. Without an argument, xc rev- 
erses switch. Initially, switch is set for no crunching. Crunched 
output has strings of tabs and blanks reduced to one blank and 
blank lines suppressed. 


See Also 


csplit(C), ed(C), regex(S) 


Diagnostics 
If prompting is turned off, a question mark is printed (?) for errors 
in commands. When prompting is on, self-explanatory error mes- 
sages appear. 
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Name 


cal — Prints a calendar. 


Syntax 


cal [| month | year] ry 


Description 


Cal prints a calendar for the specified year. If a month is also 
specified, a calendar for that month only is printed. If no arguments 
are specified, the current, previous, and following months are 
printed, along with the current date and time. The year must be a 
number between 1 and 9999; month must be a number between 1 
and 12 or enough characters to specify a particular month. For 
example, May must be given to distinguish it from March, but S is 
sufficient to specify September. If only a month string is given, only 
that month of the current year is printed. 


Notes 


Beware that ‘‘cal 84’ refers to the year 84, not 1984. 


The calendar produced is that for England and her colonies. Note a 
that England switched from the Julian to the Gregorian calendar in 
September of 1752, at which time eleven days were excised from the 

year. To see the result of this switch, try ‘‘cal 9 1752”’. 
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Name 


calendar — Invokes a reminder service. 


Syntax 


calendar [ — | 


Description 


Calendar consults the file calendar in the user’s current directory 
and mails him lines that contain today’s or tomorrow’s date. Most 
reasonable month-day dates, such as ‘‘Sep. 7,’’ ‘‘september 7’’, and 
‘*9/7’’, are recognized, but not ‘‘7 September’’, ‘‘7/12”’ or ‘‘07/12’’. 


On weekends ‘‘tomorrow’’ extends through Monday. Lines that con- 
tain the date of a Monday will be sent to the user on the previous 
Friday. This is not true for holidays. 


When an argument is present, calendar does its job for every user 
who has a file calendar in his login directory and sends the user the 
results by matl(C). Normally this is done daily, in the early morn- 
ing, under the control of cron(C). 


we Files 


calendar 


/usr/lib/calprog To figure out today’s and tomorrow’s dates 
/etc/passwd 
/tmp/cal* 


/usr/lib/crontab 


See Also 


cron(C), mail(C) 


oe Notes 
To get reminder service, a user’s calendar file must have read per- 


mission for all. 
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Name 


cat — Concatenates and displays files. 


Syntax 
cat{—u][-s] file... a) 


Description 


Cat reads each file in sequence and writes it on the standard output. 
If no input file is given, or if a single dash (— ) is given, cat reads 
from the standard input. The options are: 

— s Suppresses warnings about nonexistent files. 


— u Causes the output to be unbuffered. 


No input file may have the same name as the output file unless it is 
a special file. 


Examples 


The following example displays file on the standard output: ry 


cat file 


The following example concatenates filel and file2 and places the 
result in file3: 


cat filel file2 >file3_ 
The following example concatenates filel and appends it to file2: 


cat filel >> file2 


See Also 


cp( C), pr( C) 
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Name 


cd — Changes working directory. 


Syntax 


cd [ directory | 


Description 


Cd changes the current directory to the directory specified by dtrec- 
tory. If no directory is specified, the value of the shell parameter 
$HOME is used, and the user is placed in his home directory. The 
argument ‘‘..’’ moves up from a directory to the parent directory. 


The user must have search (execute) permission in all directories 
specified in directory. 


Examples 


The following example changes the current directory to the user’s 
home directory: 


The following command changes the current directory to 
/usr/joe/memos /meetings: 


cd /usr/joe/memos/meetings 


The following command changes the current directory from 
/usr/joe/memos /meetings to /usr/joe/accounts /overdue: 


cd ../../accounts/overdue 


See Also 


chroot(C), chdir(S), pwd(C), sh(C) 
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Name 


chgrp — Changes group ID. 


Syntax ry 
chgrp group file ... 


Description 


Chgrp changes the group ID of each file to group. The group may be 
either a decimal group ID or a group name found in the file 


/etc/group. 


Files 
/etc/passwd 


/etc/group 


See Also 


chown(C), chown(S), passwd(M), group(M) “ 


Notes 


Only the owner or the super-user can change the group ID of a file. 
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Name 


chmod — Changes the access permissions of a file or directory. 


Syntax 


chmod mode file ... 


Description 


The chmod command changes the access permissions (or mode) of a 
specified file or directory. It is used to control file and directory 
access by users other than the owner and super-user. The mode may 
be an expression composed of letters and operators (called symbolic 
mode), or anumber (called absolute mode). 


A chmod command using symbolic mode has the form: 
chmod [who] + — = [permission ...] filename 
Who is one or any combination of the following letters: 
a Stands for ‘‘all users’’. If who is not indicated on the command 


line, ais the default. The definition of ‘‘all users’’ depends on 
the user’s umask. See umask(C). 


g Stands for ‘‘group’’, all users who have the same group ID as 
the owner of the file or directory. 


o Stands for ‘‘others’’, all users on the system. 

u_—— Stands for ‘‘user’’, the owner of the file or directory. 

The operators are: 

+ Adds permission 

— Removes permission 

= Assigns the indicated permission and removes all other permis- 


sions (if any) for that who. If no permission is assigned, existing 
permissions are removed. 


vy Permissions can be any combination of the following letters: 
x Execute (search permission for directories) 
r Kead 
w Write 
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s Sets owner or group ID on execution of the file to that of the 
owner of the file. The mode ‘‘u+s’’ sets the user ID bit for the 
file. The mode ‘‘g+s’’ sets the group ID bit. Other combina- 
tions have no effect. 


t Saves text in memory upon execution. (‘‘Sticky bit’’, see 


chmod(S)). Only the mode ‘‘u+ t’”’ sets the sticky bit. All other ‘% 


combinations have no effect. This mode can only be set by the 
super-user. 


Multiple symbolic modes may be given, separated by commas, on a 
single command line. See the following Examples section for sample 
permission settings. 

A chmod command using absolute mode has the form: 


chmod mode filename 


where mode is an octal number constructed by performing logical OR 
on the following: 


4000 Set user ID on execution 
2000 Set group ID on execution 
1000 Sets the sticky bit (see chmod(S)) 
0400 Read by owner 
0200 Write by owner 
0100 Execute (search in directory) by owner 
0040 Read by group 
0020 Write by group 
0010 Execute (search in directory) by group 
0004 Read by others 
0002 Write by others 
0001 Execute (search in directory) by others 
0000 No permissions 
Examples 


Symbolic Mode 
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The following command gives all users execute permission for file: 
chmod + x file 
The following command removes read and write permission for 
& group and others from file: 
chmod go-rw file 
The following command gives other users read and write permission 


for file: 


chmod o+ rw file 
The following commmand gives read permission to group and other: 


chmod g+r,o+r file 


Absolute Mode 


The following command gives all users read, write and execute per- 
mission for fie: 


chmod 0777 file 


The following command gives read and write permission to all users 
for file: 


chmod 0666 file 


The following command gives read and write permission to the 
owner of file only: 


chmod 0600 file 


See Also 
Is(C), chmod(S) 


Notes 


The user ID, group ID and sticky bit settings are only useful for 
oS binary executable files. They have no effect on shell scripts. 
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Name 


chown — Changes owner ID. 


Syntax 


chown owner file ... 


Description 


Chown changes the owner ID of the files to owner. The owner may 
be either a decimal user ID or a login name found in the file 
/etc/passwd. 


Files 
/etc/passwd 


/etc/group 


See Also 


chgrp(C), chown(S), group(M), passwd{M) ‘y 


Notes 


Only the owner or the super-user can change a file’s owner or group 
ID. 
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Name 


chroot — Changes root directory for command. 


Syntax 


chroot newroot command 


Description 


The given command is executed relative to the new root. The 
meaning of any initial slashes (/) in pathnames is changed for a 
command and any of its children to newroot. Furthermore, the ini- 
tial working directory is newroot. 


Notice that: 
chroot newroot command >x 
creates the file x relative to the original root, not the new one. 


This command is restricted to the super-user. 


a chroot is currently in effect. The newroot argument is relative to the 
current root cf the running process. Note that it is not possible to 
change directories to what was formerly the parent of the new root 
directory; i.e., the chroot command supports the new root as an 
absolute root for the duration of the command. This means that 
‘*/..”’ is always equivalent to ‘‘/”’. 


YY The new root pathname is always relative to the current root even if 


See Also 


chdir(S) 


Notes 


Exercise extreme caution when referencing special files in the new 
root file system. 
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Name 


cmp — Compares two files. 


Syntax 


cmp [-—1][-s] fuel file2 r 


Description 


Cmp compares two files and, if they are different, displays the byte 
and line number of the differences. If file1 is — , the standard input 
is used. 


The options are: 


—1 Prints the byte number (decimal) and the differing bytes 
(octal) for each difference. 


—s Returns an exit code only, 0 for identical files, 1 for different 
files and 2 for an inaccessible or missing file. 


This command should be used to compare binary files; use diff(C) 


or diff?(C) to compare text files. “Aa 


See Also 


comm(C), diff(C), diff3(C) 


Diagnostics 


Exit code 0 is returned for identical files, 1 for different files, and 2 
for an inaccessible or missing argument. 
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Name 


comm — Selects or rejects lines common to two sorted files. 


Syntax 


comm [ — [ 123] | filel file2 


Description 


Comm reads file1 and file2, which should be ordered in ASCII collat- 
ing sequence (see sort(C)), and produces a three-column output: 
lines only in file1; lines only in file2; and lines in both files. The 
filename — means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding column. 
Thus comm — 12 prints only the lines common to the two files; 


comm — 23 prints only lines in the first file but not in the second; 
comm — 123 is a no-op. 


See Also 
emp(C), diff(C), sort(C), uniq(C) 


9 . 
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Name 


copy — Copies groups of files. 


Syntax 


copy [ option ] ... source ... dest 


Description 


The copy command copies the contents of directories to another 
directory. It is possible to copy whole file systems since directories 
are made when needed. 


If files, directories, or special files do not exist at the destination, 
then they are created with the same modes and flags as the source. 
In addition, the super- user may set the user and group ID. The 
owner and mode are not changed if the destination file exists. Note 
that there may be more than one source directory. If so, the effect 
is the same as if the copy command had been issued for each source 
directory with the the same destination directory for each copy. 


All of the options must be given as separate arguments and they 
may appear in any order even after the other arguments. The argu- 
ments are: 


—a Asks the user before attempting a copy. If the response 


does not begin with a ‘‘y’’, then a copy is not done. This 
option also sets the — ad option. 


— | Uses links instead whenever they can be used. Otherwise a 
copy is done. Note that links are never done for special 
files or directories. 


—n Requires the destination file to be new. If not, then the 
copy command does not change the destination file. The 
—n flag is meaningless for directories. For special files an 
—n flag is assumed (i.e., the destination of a special file 
must not exist). 


—o If set then every file copied has its owner and group set to 
those of the source. If not set, then the file’s owner is the 
user who invoked the program. 


—m If set, then every file copied has its modification time and 
access time set to that of the source. If not set, then the 
modification time is set to the time of the copy. 


-r If set, then every directory is recursively examined as it is 
encountered. If not set then any directories that are found 
are ignored. 
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— ad Asks the user whether an — r flag applies when a directory 
is discovered. If the answer does not begin with a ‘‘y’’, 


then the directory is ignored. 


—v If the verbose option is set messages are printed that reveal 
what the program is doing. 


source This may be a file, directory or special file. It must exist. If 
it is not a directory, then the results of the command are 
the same as for the cp command. 


des t The destination must be either a file or directory that is 
different from the source. 


If the source and destination are anything but directories, then copy 
acts just like a cp command. If both are directories, then copy copies 
each file into the destination directory according to the flags that 
have been set. 


Notes 


Special device files can be copied. When they are copied any data 
associated with the specified device is not copied. 
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Name 


cp — Copies files. 


Syntax 


cp filel file2 ry 


cp files directory 


Description 


There are two ways to use the cp command. With the first way, filel 
is copied to file2. Under no circumstance can filef and file? be 
identical. With the second way, directory is the location of a direc- 
tory into which one or more files are copied. 


See Also 


copy(C), cpio(C), In(C), mv(C), rm(C), chmod(S) 


Notes 


Special device files can be copied. If the file is a named pipe, then “y 
the data in the pipe is copied to a regular file. Similarly, if the file is 


a device, then the file is read until the end-of-file is reached, and 
that data is copied to a regular file. It is illegal to copy a directory to 
a file. 
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Name 


cpio — Copies file archives in and out. 


Syntax 
cpio — o[ acBv | 


cpio — i [ Bcdmrtuv | [ patterns | 


cpio — p[ adImruv | directory: 


Description 


Cpio — o (copy out) reads the standard input to obtain a list of path- 
names and copies those files onto the standard output together with 
pathname and status information. 


Cpio — 1 (copy in) extracts from the standard input (which is 
assumed to be the product of a previous cpio — o) the names of files 
selected by zero or more patterns given in the name-generating nota- 
tion of sh(C). In patterns, the special characters ?, *, and [...] 
match the slash ( / ) character. The default for patterns is * (i.e., 


YY select all files). 
Remember to escape special.characters to prevent expansion by the 


shell. 


Cpio — p (pass) copies out and in during a single operation. Destina- 
tion pathnames are interpreted relative to the named directory. 


The meanings of the available options are: 


—a Resets access times of input files after they have been 
copied. 


—B_ Blocks input/output 5,120 bytes to the record (does not 
apply to the pass option; meaningful only with data directed 
to or from raw devices). 


BEE «| Directories are created as needed. 


Writes header information in ASCII character form for porta- 
bility. 


Interactively renames files. If the user types a null line, the 
file is skipped. 


— +t Prints a table of contents of the input. No files are created. 
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—u Copies unconditionally (normally an older file will not 
replace a newer file with the same name). 


—vV Verbose: causes a list of filenames to be printed. When used 
with the — t option, the table of contents looks like the out 
put of an Ils — 1 command (see Js (C)). 


— | Whenever possible, links files rather than copying them. 
Usable only with the — p option. 


—m _ Retains previous file modification time. This option is 
ineffective on directories that are being copied. 
Examples 


The first example below copies the contents of a directory into an 
archive; the second duplicates a directory hierarchy: 


ls | cpio — o >/dev/fd0 


ed olddir 
find . — print | cpio — pdl newdir 


find . — print | cpio - oB >/dev/rfd0”’ "y 


See Also 


ar(CP), find(C), cpio(F) 


Notes 


Pathnames are restricted to 128 characters. If there are too many 
unique linked files, the program runs out of memory to keep track 
of them and thereafter linking information is lost. Only the super- 
user can copy special files. 
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Name 


cron — Executes commands at specified times. 


Syntax 


/etc/cron 


Description 


Cron is the clock daemon that executes commands at specified dates 
and times according to the instructions in the file /usr/lib/crontab. 
Because cron never exits, it should be executed only once. This is 
best done by running cron from the initialization process through the 


file /etc/rec. 


The file crontab consists of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the minute (0-59), hour (0-23), day of the month (1-31), 
month of the year (1-12), and day of the week (0-6, with 0=Sun- 
day). Each of these patterns may contain: 


— A number in the (respective) range indicated above 


—~ Two numbers separated by a minus (indicating an inclusive 
range) 


— A list of numbers separated by commas (meaning all of these 
num bers) 


— An asterisk (meaning all legal values) 


The sixth field is a string that is executed by the shell at the specified 
time(s). A % in this field is translated into a newline character. 
Only the first line (up to a %or end-of-line) of the command field is 
executed by the shell. The other lines are made available to the 
command as standard input. 


Cron examines crontab periodically to see if it has changed; if it has, 
cron reads it. Thus it takes only a short while for entries to become 


effective. 
& Examples 
An example crontab file follows: 
30 4 * * * /etc/sa-s > /dev/null 
0 4*** calendar - 
154 *** find /usr/preserve -mtime +7 -a-exec rm -f {}; 
304111 /usr/lib/uucp/cleanlog 
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404*** find / -name ’#* -atime + 3 -exec rm -f {}; 
0,5,10,15,20,25,30,35,40,45,50,55 * * * * /usr/lib/atrun 
0,10,20,30,40,50 * * * */etc/dmesg - >>/usr/adm/messages 
1,21,41 * * ** (echo-n’’; date; echo ) >/dev/console 


A history of all actions by cron can be recorded in /usr/lib/cronlog. 
This logging occurs only if the variable CRONLOG in 
/etc/default/cron is set to YES. By default this value is set to NO 
and no logging occurs. If logging should be turned on, be sure to 
monitor the size of /usr/lib/crontab so that it doesn’t unreasonably 
consume disk space. 


Files 
/usr/lib/crontab 
/usr/lib/cronlog 


/etc/default/cron 


See Also 


sh(C) 


Notes ry 


Cron reads crontab only when it has changed, but it reads the in- 
core version of that table periodically. 
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Name 


crypt — Encodes and decodes files. 


Syntax 


crypt [ password ] 


Description 


Crypt reads from the standard input and writes on the standard out- 
put. The password is a key that selects a particular transformation. 
If no password is given, crypt demands a key from the terminal and 
turns off printing while the key is being typed in. Crypt encrypts and 
decrypts with the same key. 


Files encrypted by crypt are compatible with those created by the edi- 
tor ed (C) in encryption mode. 


The security of encrypted files depends on three factors: the funda- 
mental method of encryption must be hard to solve; direct search of 
the key space must be infeasible; ‘‘sneak paths’’ by which keys or 
clear text can become visible must be minimized. 


The transformation of a key into the internal settings of the machine 
is deliberately designed to be expensive, i.e. to take a substantial 
fraction of a second to compute. However, if keys are restricted to 
(say) three lowercase letters, then encrypted files can be read by 
expending less than five minutes of machine time. 


Since the key is an argument to the crypt command, it is potentially 
visible to users executing ps(C) or a derivative. To minimize this 
possibility, crypt destroys any record of the key immediately upon 
entry. The choice of keys and key security are the most vulnerable 
aspect of crypt. 

Example 
The following will print the contents of the file clear: 


crypt key <clear >cypher 


Y crypt key <cypher | pr 


See Also 


ed(C), makekey(M) 
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Notes 


If output is piped to nroff(CT) and the encryption key is not given 
on the command line, crypt can leave terminal modes in a strange 
state (see stty(C)}. 


Crypt implements a one-rotor machine designed along the lines of 
the German Enigma, but with a 256-element rotor. Methods of 
attack on such machines are known, but not widely; moreover the 
amount of work required is likely to be large. 
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Name 


csplit— Splits files according to context. 


Syntax 


csplit [— s] [— k] [— f prefix] file arg1 [... argn] 


Description 


Csplit reads file and separates it into n+ 1 sections, defined by the 
arguments argi... argn. By default the sections are placed in xx00 

xxn (n may not be greater than 99). These sections get the fol- 
lowing pieces of file: 


00: From the start of file up to (but not including) the line refer- 
enced by arg1. 


01: From the line referenced by argi up to the line referenced by 
arg?. 


n+ 1: From the line referenced by argn to the end of file. 
The options to csplit are: 


—s Ceplit normally prints the character counts for each file 
created. If the — s option is present, ceplit suppresses the 
printing of all character counts. 


—k Ceplit normally removes created files if an error occurs. 
If the — k option is present, csplit leaves previously 
created files intact. 


—f prefiz If the —f option is used, the created files are named 
prefiz0O ... prefirn. The default is xx00 ... xxn. 


The arguments (argi ... argn) to ceplit can be a combination of 
the following: 


/rezp/ A file is to be created for the section from the current line 
up to (but not including) the line containing the regular 
expression rezp. The current line becomes the line contain- 
ing rezp. This argument may be followed by an optional 
+or— some number of lines (e.g., /Page/— 5). 


%rezp% This argument is the same as /rezp/, except that no file is 
created for the section. 
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Inno _— A file is to be created from the current line up to (but not 
including) Inno. The current line becomes Inno. 


{num} Repeat argument. This argument may follow any of the 
above arguments. If it follows a rezp type argument, that 
argument is applied num more times. If it follows Inno, the 
file will be split every Inno lines (num times) from that 
point. 


Enclose all rezp type arguments that contain blanks or other charac- 
ters meaningful to the shell in the appropriate quotation marks. 
Regular expressions may not contain embedded newlines. Csplit 
does not affect the original file; it is the users responsibility to 
remove it. 


Examples 


csplit — f cobol file ’/procedure division/’ /par5./ /par16./ 


This example creates four files, cobol00 ... cobol03. After editing 
the ‘‘split’’ files, they can be recombined as follows: 


cat cobol0[0- 3] > file 


Note that this example overwrites the original file. 

csplit — k file 100 {99} ry 
This example would split the file at every 100 lines, up to 10,000 
lines. The — k option causes the created files to be retained if there 


are less than 10,000 lines; however, an error message would still be 
printed. 


esplit —- k prog.c /%main(% '/*}/+ 1’ {20} 
Assuming that prog.c follows the normal C coding convention of 
ending routines with a } at the beginning of the line, this example 
will create a file containing each separate C routine (up to 21) in 
prog.c. 
See Also 


ed(C), sh(C), regex(S) 
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Diagnostics 
Self-explanatory except for: 
arg — outof range 


which means that the given argument did not reference a line 
between the current position and the end of the file. 
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Name 


cu — Calls another XENIX system. 


Syntax 


cu [— sspeed] [-— aacu] [- lline] [- h] [— o} e] telno 


cu [— sspeed] — line [— h] [— of e] dir 


Description 


Cu ‘‘calls up’’ another XENIX system through a modem or a direct 
serial connection. It also controls the transmission and reception of 
data and programs during the call. Cu looks at each line in the file 
/usr/lib/uucp/L-devices until it finds a line that matches the 
options given in the command line. If it finds an appropriate line, it 
will attempt to make a connection. If it cannot find the proper line, 
cu quits. 


The options are: 


— sspeed 
Specifies the transmission speed. 1200 baud is the default value. 
Other speeds available are 110, 150, 300, 1200, 2400, 4800 and 
9600 baud. Directly connected lines may be set to other speeds. 
Most modems are restricted to 300 and 1200 baud. 


— aacu 
Specifies the device name of the ACU (automatic calling unit) 
device. When used with the — | option, overrides the search for 
the first available ACU with the right speed. 


— lline 
Specifies the device name of the communications line. When 
used with the — a option, overrides the search for the first avail- 
able ACU with the right speed. 


— h Emulates local echo. This feature supports calls to systems that 
expect half-duplex mode terminals. 


—e Specifies that even-parity data is to be generated for data sent to 
the remote system. 


— o Specifies that odd-parity data is to be generated for data sent to 
the remote system. 


Telno is the telephone number of the remote system. A comma 
indicates a delay at appropriate places, for example, to wait for a 
secondary dial tone when calling from an internal phone system. For 
directly connected lines, the string ‘‘dir’’ is used instead of telno. 
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Direct lines require a line to be specified, but no ACU. See the 
Examples later in this section for sample command lines. 


After making the connection, cu runs as two processes: transmit and 
receive. The transmit process reads data from the standard input 
and, except for lines beginning with a tilde (7), passes it to the 
remote system. The recetve process accepts data from the remote 
system and, except for lines beginning with a tilde, passes it to the 
standard output. Normally, an automatic XON/XOFF (DC3/DCl1) 
protocol controls input from the remote system so the buffer is not 
overrun. Lines beginning with a tilde have special meanings. 


The transmit process interprets lines beginning with a tilde as fol- 


lows: 

: Terminates the conversation. 

a Escapes to an interactive shell on the local sys- 
tem. 

“ema. i. Runs emd on the local system (via sh — c). 

“$emd... Runs cmd locally and sends its output to the 


remote system. 


“Stake remote [ local | 

Copies file remote (on the remote system) to 
file local on the local system. If local is omit 
ted, the remote filename is used in both places. 
Use of this line requires the existence of 
echo(C) and cat(C) on the remote system. If 
tabs are to be copied without expansion, stty 
tabs mode should be set on the remote sys- 
tem. 


“Yput local [| remote | 

Copies file local (on the local system) to file 
remote on the remote system. If local is omit 
ted, the remote filename is used in both places. 
Use of this line requires the existence of 
stty(C) and cat(C) on the remote system. It 
also requires that the current erase and kill 
characters on the remote system be identical to 
the current ones on the local system. 
Backslashes are inserted at appropriate places. 


& pa Sends the line ©... to the remote system. 


“nos top Turns off the XON/XOFF input control proto- 
col for the remainder of the session. This is 
useful if the remote system is one which does 
not respond properly to the characters. 
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The recetve process normally copies data from the remote system to 
its standard output. A line from the remote system that begins with 
“> diverts the output to a file. Data is appended to a file if “>> is 
used. The diversion is terminated by a trailing “>. The complete 
sequence is: 


zero or more lines to be written to file ry 


">[>]: file 
> 


Examples 

A sample command line might be: 

cu -s2400 -1/dev/cua0 4479801 
Where ‘‘s-2400’’ indicates a line speed of 2400 baud, and 
‘‘_ |/dev/cuaO”’ is the device name of the communications line. The 
system looks in the file L— devices for a line with these characteris- 
tics.‘‘4479801’’ is the phone number of the remote system. For a 
directly connected line: 

cu -l/dev/tty01 dir 
‘‘Dir’’ indicates a direct line connection. ‘y 
To dial out of an internal phone system, such as a computerized 
branch exchange (CBX): 

~ cu -s2400 -]1/dev/cua0 9,4479801 


If your system does not automatically wait for an outgoing dial tone, 
use several commas for an extended delay: 


cu -s2400 -1/dev/cua0 9,,,4479801 


Files 
/usr/lib/uucp/L- devices Device information 
/usr/spool/uucp/LCK..(tty- device) Lockout mechanism 
/usr/lib/uucp/dial Dialer program 


/dev/null ry 
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See Also 
cat(C), echo(C), stty(C), tty(M) 


Diagnostics 


Exit code is zero for normal exit, nonzero (various values) other- 
wise. 


Notes 


There is an artificial slowing of transmission by cu during the ~%put 
operation so that loss of data is unlikely. 


ASCII files only can be transferred using “%ake or “%put; binary 
files cannot be transferred. 
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Name 


date — Prints and sets the date. 


Syntax 


date [ mmddhhmm|[yy] | [ +format | 


Description 


If no argument is given, or if the argument begins with +, the 
current date and time are printed. Otherwise, the current date is set. 
The first mm is the month number; dd is the day number in the 
month; hh is the hour number (24-hour system); the second mm is 
the minute number; yy is the last 2 digits of the year number and is 
optional. For example: 


date 10080045 


sets the date to Oct 8, 12:45 AM. The current year is the default if 
no year is mentioned. The system operates in GMT. Date takes care 
of the conversion to and from local standard and daylight time. 


If the argument begins with +, the output of date is under the con- 
trol of the user. The format for the output is similar to that of the 
first argument to pnntf{(S). All output fields are of fixed size (zero 
padded if necessary). Each field descriptor is preceded by a percent 
sign (% and will be replaced in the output by its corresponding 
value. A single percent sign is encoded by doubling the percent 
sign, i.e., by specifying ‘‘%%’. All other characters are copied to the 
output without change. The string is always terminated with a new- 
line character. 


Field Descriptors: 

n_ Inserts a newline character 

t Inserts a tab character 
Month of year-— 01 to 12 

d Day of month —- 01 to 3l 


Last 2 digits of year-— 00 to 99 


Date as mm/dd/yy 


Hour— 00 to 23 


ea ey 


Minute — 00 to 59 
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S Second— 00 to 59 
T Time as HH:MM:SS 
j Julian date — 001 to 366 


YY w Day of the week -— Sunday = 0 


a Abbreviated weekday — Sun to Sat 


h Abbreviated month—- Jan to Dec 


r Time in AM/PM notation 


Fasuile 
The line 
date ‘+ DATE: %m/%d/%y %n TIME: %H:%M: %S! 
generates as output: 


DATE: 08/01/76 
TIME: 14:45:05 


& Diagnostics 


no permission You aren’t the super-user and you are trying 
to change the date. 


bad conversion The date set is syntactically incorrect. 


bad format character The field descriptor is not recognizable. 
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Name 


dc — Invokes an arbitrary precision calculator. 


Syntax 


de [ file | 


Description 


De is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but you may specify an input base, output base, 
and a number of fractional digits to be maintained. The overall 
structure of de is a stacking (reverse Polish) calculator. If an argu- 
ment is given, input is taken from that file until its end, then from 
the standard input. The following constructions are recognized: 


number 
The value of the number is pushed on the stack. A number 
is an unbroken string of the digits 0O— 9. It may be preceded 
by an underscore (_) to input a negative number. Numbers 
may contain decimal points. 


a ie Mile | 
The top two values on the stack are added (+), subtracted 
(— ), multiplied (*), divided (/), remaindered (%, or 


exponentiated (*). The two entries are popped off the stack; 
the result is pushed on the stack in their place. Any fractional 
part of an exponent is ignored. 


Sz The top of the stack is popped and stored into a register 
named z, where z may be any character. If the s is capital- 
ized, z is treated as a stack and the value is pushed on it. 


lz The value in register z is pushed on the stack. The register z 
is not altered. All registers start with zero value. If the 1 is 
capitalized, register z is treated as a stack and its top value is 
popped onto the main stack. 


d The top value on the stack is duplicated. 


Pp The top value on the stack is printed. The top value remains 
unchanged. p interprets the top of the stack as an ASCII 
string, removes it, and prints it. 


f All values on the stack are printed. ry 


q Exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack 
is popped and the string execution level is popped by that 
value. 
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x Treats the top element of the stack as a character string and 


executes it as a string of de commands. 


xX Replaces the number on the top of the stack with its scale fac- 
tor. 


Puts the bracketed ASCII string onto the top of the stack. 


= 
° 
o 
° 
feet 


<z >r =2 
The top two elements of the stack are popped and compared. 
Register z is evaluated if they obey the stated relation. 


Vv Replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 


! Interprets the rest of the line as a XENIX command. 
Cc All values on the stack are popped. 
i The top value on the stack is popped and used as the number 


radix for further input. 
I Pushes the input base on the top of the stack. 


oO The top value on the stack is popped and used as the number 
radix for further output. 


O Pushes the output base on the top of the stack. 


The top of the stack is popped, and that value is used as a 
nonnegative scale factor; the appropriate number of places are 
printed on output, and maintained during multiplication, divi- 
sion, and exponentiation. The interaction of scale factor, 
input base, and output base will be reasonable if all are 
changed together. 


Zz The stack level is pushed onto the stack. 
Z Replaces the number on the top of the stack with its length. 
? A line of input is taken from the input source (usually the 


terminal) and executed. 


ae Used by be for array operations. 
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Example 
This example prints the first ten values of n!: 


[lal+ dsa*plal0>y]sy 


Osal 
lyx 
See Also 
be(C) 
Diagnostics 
z 18 unimplemented The octal number z corresponds to a char- 
acter that is not implemented as a com- 
mand 
stack empty Not enough elements on the stack to do 
what was asked 
Out of space The free list is exhausted (too many digits) 
Out of headers Too many numbers being kept around 
Out of pushdown Too many items on the stack 
Nesting Depth Too many levels of nested execution 
Notes 


Be is a preprocessor for dc, providing infix notation and a C-like syn- 
tax which implements functions and reasonable control structures 
for programs. For interactive use, bc is preferred to dc. 
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Name 


dd-— Converts and copies a file. 


Syntax 


dd [option==value] ... 


Description 


Dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. 
The input and output block size may be specified to take advantage 
of raw physical I/O. 


Option Value 

if=file Input filename; standard input is default 

of=file Output filename; standard output is default 

ibs =n Input block size n bytes (default 512) 

obs ==n Output block size (default 512) 

bs==n Sets both input and output block size, superseding 


tbs and obs; also, if no conversion is specified, it 
is particularly efficient since no in-core copy needs 


to be done 
cbs =n Conversion buffer size 
skip=n Skips n input records before starting copy 
seek =n Seeks n records from beginning of output file 


before copying 


count=—=n Copies only n input records 
conv=ascil Converts EBCDIC to ASCII 
conv=ebcdic Converts ASCII to EBCDIC 
— conv=ibm Slightly different map of ASCII to EBCDIC 
we conv=Icase Maps alphabetics to lowercase 
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conv—=ucase Maps alphabetics to uppercase 

conv==s wab Swaps every pair of bytes 

Option Value 

conv=noerror Does not stop processing on an error ry 
conv=sync Pads every input record to tbs el 


conv=—”...,...” Several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number 
may end with k, b, or wto specify multiplication by 1024, 512, or 2 
respectively; a pair of numbers may be separated by x to indicate a 
product. 


Cbs is used only if asct or ebcdte conversion is specified. In the 
former case cbe characters are placed into the conversion buffer, 
converted to ASCII, and trailing blanks trimmed and newline added 
before sending the line to the output. In the latter case ASCII char- 
acters are read into the conversion buffer, converted to EBCDIC, and 
blanks added to make up an output record of size cbe. 


After completion, dd reports the number of whole and partial input 
and output blocks. a. 
Examples : 


This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile: 


dd if=/dev/rmt0 of=outfile ibs=800 cbs=80 conv=ascii,lcase 
Note the use of raw magtape. Dd is especially suited to I/O on raw 
physical devices because it allows reading and writing in arbitrary 
record sizes. 


See Also 


copy(C), ep(C), tar(C) 


Diagnostics 
{+ p recorde in{out) Numbers of full and _ partial records ry 


read( written) = 
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Notes 


The ASCII/EBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The thm conversion 
corresponds better to certain IBM print train conventions. There is 


YY no universal solution. 


Newlines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. 
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Name 


devnm — Identifies device name. 


Syntax 


/etc/devnm [ names] ry 


Description 


Devnm identifies the special file associated with the mounted file sys- 
tem where the argument name resides. 


This command is most commonly used by /etc/re to construct a 
mount table entry for the root device. 
Examples 
Be sure to type full pathnames in this example: 
/etc/devnm /usr 


If /dev/hdl is mounted on /usr, this produces: “Aa 
hdl /usr 


Files 
/dev/* Device names 


/etc/rc Xenix startup commands 


See Also 


setmnt{ C) 
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Name 


df — Reports the number of free disk blocks. 


Syntax 


df{—t][-f] [ filesystem ... ] 


Description 


Df prints out the number of free blocks and free inodes available for 
on-line file systems by examining the counts kept in the super- 
blocks. One or more filesystem arguments may be specified by dev- 
ice name (for example, /dev/hdO or /dev/usr). If the filesystem 
argument is unspecified, then the free space on all mounted file sys- 
tems is sent to the standard output. The list of mounted file systems 
is given in /etc/mnttab. 


The — t flag causes the total allocated block figures to be reported as 
well. 


If the — f flag is given, only an actual count of the blocks in the free 
list is made (free inodes are not reported). With this option, df 


Y reports on raw devices. 


Files 


/dev /* 


/etc/mnttab 


See Also 


fsck(C), mnttab(F) 


Notes 


See Notes under mount(C). 


——. 


March 24, 1984 Page 1 


DIFF (C) DIFF (C) 


Name 


diff - Compares two text files. 


Syntax 


diff | — efbh ] file1 file2 


Description 


Diff tells what lines must be changed in two files to bring them into 
agreement. If filet (file2) is — , the standard input is used. If filed 
(file2) is a directory, then a file in that directory with the name file? 
(file1) is used. The normal output contains lines of these forms: 


nl anég,n4 
n1l,n2 dn 
n1,n2 c n8&,n4 


These lines resemble ed commands to convert file1 into file2. The 
numbers after the letters pertain to file2. In fact, by exchanging a 
for d and reading backward one may ascertain equally how to con- 
vert file? into file1. As in ed, identical pairs where nf = n2 or n8 
= n4 are abbreviated as a single number. 


Following each of these lines come all the lines that are affected in 
the first file flagged by <, then all the lines that are affected in the 
second file flagged by >. 


The — b option causes trailing blanks (spaces and tabs) to be ignored 
and other strings of blanks to compare equal. 


The — e option produces a script of a, ¢ and d commands for the 
editor ed, which will recreate file2 from file1. The — f option pro- 
duces a similar script, not useful with ed, in the opposite order. In 
connection with — e, the following shell procedure helps maintain 
multiple versions of a file: 


(shift; cat $*; echo '1,$p’) Jed- $1 


This works by performing a set of editing operations on an original 
ancestral file. This is done by combining the sequence of ed scripts 
given as all command line arguments except the first. These scripts 
are presumed to have been created with diff in the order given on 
the command line. The set of editing operations is then piped as an 
editing script to ed where all editing operations are performed on the 
ancestral file given as the first argument on the command line. The 
final version of the file is then printed on the standard output. Only 
an ancestral file ($1) and a chain of version-to-version ed scripts 
($2,$3,...) made by diff need be on hand. 
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Except in rare circumstances, diff finds the smallest sufficient set of 
file differences. 


The — h option does a fast, less-rigorous job. It works only when 
changed stretches are short and well separated, but also works on 


files of unlimited length. The — e and — f cannot be used with the 
— h option. 


Files 


/usr/lib/diffh for — h 


See Also 


emp(C), comm(C), ed(C) 


Diagnostics 


Exit status is 0 for no differences, 1 for some differences, 2 for 
errors. 


VU Notes 


Editing scripts produced under the — e or — f option do not always 
work correctly on lines consisting of a single period (.). 


— 
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Name 


diff3 - Compares three files. 


Syntax 


diff3 | — ex3 | filel file2 file3 ry 


Description 


Diff compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 


All three files differ 


ee | File1 is different 
== == == 2 File? is different 
eee ee Fie8 is different 


The type of change suffered in converting a given range of a given 
file to some other range is indicated in one of these ways: 


f ¢ nica Text is to be appended after line number ni in “A 
file f, where f = 1, 2, or 3. 

S394; ae Text is to be changed in the range line ni to 
line n2. If nf = n2, the range may be abbre- 
viated to ni. 


The original contents of the range follows immediately after a c indi- 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 


Under the — e option, diff8 publishes a script for the editor ed that 
will incorporate into file1 all changes between file2 and file, i.e., the 
changes that normally would be flagged ===>== and ==>==>=3. 
The — x option produces a script to incorporate changes flagged with 

====’’, Similarly, the — 3 option produces a script to incor- 
porate changes flagged with ‘‘===>=3’’. The following command 
applies a resulting editing script to file/: 


(cat script; echo '1,$p’) |ed — filel 


Files 
/tm p/d3* 


/usr/lib/diff3 prog 
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See Also 


diff( C) 


& Notes 
The — e option does not work properly for lines consisting of a single 
period. 


The input file size limit is 64K bytes. 
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Name 


dircmp — Compares directories. 


Syntax 


dircmp [— d] [- s] dirl dir2 


Description 


Diremp examines dir! and dir2 and generates tabulated information 
about the contents of the directories. Listings of files that are unique 
to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same con- 
tents. 


There are two options available: 


— d Performs a full diff on each pair of like-named files if the con- 
tents of the files are not identical 


ce 


— s Reports whether files are ‘‘same’’ or ‘‘different’’ 


See Also 


cmp(C), diff(C) 
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Name 


dirname — Delivers directory part of pathname. 


Syntax 


dirname string 


Description 


Dirname delivers all but the last component of the pathname in string 
and prints the result on the standard output. If there is only one 
component in the pathname, only a ‘‘dot’’ is printed. It is normally 
used inside substitution marks ( * ‘) within shell procedures. 


The companion command basename deletes any prefix ending in a 
slash (/) and the suffiz (if present in string) from string, and prints 
the result on the standard output. 


Examples 


The following example sets the shell variable NAME to 


/usr/sre/cmd: 
& NAME= “dirname /usr/src/cmd/cat.c * 


This example prints /a/b/c on the standard output: 


basedname /a/b/c/d 
This example prints a ‘‘dot’’ on the standard output: 


basename file.ext 


See Also 


basename(C), sh(C) 
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Name 


disable — Turns off terminals. 


Syntax 
disable [- d] [ [ — e] tty ... fs 


Description 


This program manipulates the /etcftys file and signals init to disallow 
logins on a particular terminal. The — d and — e options ‘‘disable’’ 
and ‘‘enable’’ terminals, respectively. 


Ex amples 


A simple example follows: 


disable tty01 
Multiple terminals can be disabled or enabled using the — d and 


— eswitches before the appropriate terminal name: 


disable ttyO1 — e tty02 — d tty03 tty04 ny 


/dev /tty* 


Files 


/etc/ttys 


See Also 


login(M), enable(C), ttys(M), getty(M), init(M) 


Warning 


Be absolutely certain to pause at least one minute before reusing this 


command or before using the enable command. Failure to do so ry 


may cause the system to crash. 
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Name 


DOS (C) 


dos — Accesses MSDCS files. 


Syntax 


doscat [ - r] file ... 


doscp [ - r] filel file2 


doscp [ - r] file ... directory 


dosdir directory ... 


dosIs directory ... 


dosmkdir directory ... 


dosrm file ... 


dosrmdir directory ... 


Description 


The dos commands provide access to the files and directories on MS- 
DOS disks. The commands perform the following actions: 


doscat 


doscp 


dosdir 


dosls 


dosrm 
dosmk dir 


dosrmdir 
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Copies one or more MS-DOS files to the standard out 
put. If — r is given, the files are copied without new- 
line conversions (see ‘‘Conversions’’ below). 


Copies files between an MS-DOS disk and a XENIX file 
system. If file1 and file? are given, filel is copied to 
file2. If a directory is given, one or more files are 
copied to that directory. If the — r is given, the files 
are copied without newline conversions (see ‘‘Conver- 
sions’’ below). 


Lists MS-DOS files in the standard MS-DOS style direc- 
tory format. 


Lists MS-DOS directories and files in a XENIX style (see 
ls(C)). 


Removes files from an MS-DOS disk. 
Creates a directory on an MS-DOS disk. 


Deletes directories from an MS-DOS disk. 
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The file and directory arguments for MS-DOS files and directories 
have the form 


device:name 


where device is a XENIX pathname for the special device file contain- 
ing the MS-DOS disk, and name is a pathname to a file or directory 
on the MS-DOS disk. The two components are separated by a colon 
(:). For example, the argument 


/dev /fd0:/src/file.asm 


specifies the MS-DOS file, file.asm, in the directory, /src, on the disk 
in the device file /dev/fd0. Note that slashes (and not backslashes) 
are used as filename separators for MS-DOS pathnames. Arguments 
without a device: are assumed to be XENIX files. 


For convenience, the default file, /etc/default/msdos, can define 
MS-DOS drive names to be used in place of the special device file 
pathnames. For example, if the file contains the line 


A=/dev/fd0 


then drive letter ‘‘A’’ may be used in place of special device file 
pathname /dev/fdO when referencing MS-DOS files (see ‘‘Examples”’ 
below). 


The commands operate on the following kinds of disks: 


5 1/4 inch MS-DOS 

8 or 9 sectors per track 
40 tracks per side 

1 or 2 sides 


MS-DOS version 1 or 2 


Conversons 


All MS-DOS text files use a carriage-return/linefeed combination, 
CR-LF , to indicate a newline. XENIX uses a single newline LF char- 
acter. When the doscat and doscp commands transfer MS-DOS text 
files to XENIX , they automatically strip the CR. When text files are 
transferred to MS-DOS , the commands insert the CR before each LF 
character. The — r option can be used to override the automatic 
conversion and force the command to perform a true byte copy 
regardless of file type. 


Examples 


doscat /dev/fd0:/docs/memo.txt 
doscat /tmp/fl /tmp/f2 /dev/fd0:/src/file.asm 
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dosdir /dev/fd0:/sre 
dosdir A:/sre A:/dev 


doscp /tmp/myfile.txt /dev/fd0:/docs/memo.txt 
doscp /tmp/f1 /tmp/f2 /dev/fd0:/mydir 


dosls /dev/fd0:/sre 
dosls B: 


dosmkdir /dev/fd0:/usr/docs 


dosrm /dev/fd0:/docs/memo.txt 
dosrm A:/docs/memol.txt 


dosrmdir /dev/fd0:/usr/docs 


Files 
/etc/default/msdos Default information 


/dev /fd+* Floppy disk devices 


See Also 


dtype(C) 


Notes 


It is not possible to refer to MS-DOS directories with wild card 
specifications. It is the user’s responsibility to ensure he has 
exclusive access to the device containing the MS-DOS disk. If two or 
more processes simultaneously attempt to access the MS-DOS disk 
the result is unpredictable. 
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Name 


dtype — Determines disk type. 


Syntax 


dtype [— s] device ... 


Description 


Dtype determines type of disk, prints pertinent information on the 
standard output unless the silent (— s) option is selected, and exits 
with a corresponding code (see below). When more than one argu- 
ment is given, the exit code corresponds to the last argument. 


jMiiee, ee eeeiepecified) 
| 71 | tar format{, extente ofn] 


3 
7 
7 
7 cpio character (— c) format 
9 
) 
0) 


MS-DOS 1.x, 8 sec/track, dual sided 


a ae 

1 
pee 
| 80 | MS-DOS 1.x, 8 sec/track, single sided 
a. aah 
| 90 | MS-DOS 2.x, 8 sec/track, single sided | 
| 91 | MS-DOS 2.x, 8 sec/track, dual sided _| 


Notes 


XENIX file systems and dump and cpio binary formats may not be 
recognized if created on a foreign system. This is due to such sys- 
tem differences as byte and word swapping and structure alignment. 
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Name 


du — Summarizes disk usage. 


Syntax 


du [ — afrsu | [ names ] 


Description 


Du gives the number of blocks contained in all files and (recur- 
sively) directories within each directory and file specified by the 
names argument. The block count includes the indirect blocks of the 
file. If names is missing, the current directory is used. 


The optional argument — s causes only the grand total (for each of 
the specified names) to be given. The optional argument — a causes 
an entry to be generated for each file. Absence of either causes an 
entry to be generated for each directory only. 


The — f option causes du to display the usage of files in the current 
file system only. Directories containing mounted file systems will be 
ignored. The — u option causes du to ignore files that have more 
than one link. 


Du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The —r option will cause du to generate 
messages in such instances. 


A file with two or more links is only counted once. 


Notes 


If the — a option is not used, nondirectories given as arguments are 
not listed. 


If there are too many distinct linked files, du will count the excess 
files more than once. 


Files with holes in them will get an incorrect block count. 
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Name 


dump — Performs incremental file system backup. 


Syntax 


dump [ key [ arguments ] filesystem ] 


Description 


Dump copies to the specified device all files changed after a certain 
date in the filesystem. The key specifies the date and other options 
about the backup, where a key consists of characters from the set 


0123456789kfusd. The meanings of these characters are described 
below: 


f Places the backup on the next argument file instead of the 
default device. 


u If the backup completes successfully, writes the date of the 
beginning of the backup to the file /etc/ddate. This file 
records a separate date for each file system and each backup 
level. 


O— 9 This number is the ‘‘backup level’’. Backs up all files modified 
since the last date stored in the file /etc/ddate for the same file 
system at lesser levels. If no date is determined by the level, 
the beginning of time is assumed; thus the option O causes the 
entire file system to be backed up. 


s For backups to magnetic tape, the size of the tape specified in 
feet. The number of feet is taken from the next argument. 
When the specified size is reached, dump will wait for reels to 
be changed. The default size is 2,300 feet. 


d For backups to magnetic tape, the density of the tape, 
expressed in BPI, is taken from the next argument. This is used 
in calculating the amount of tape used per write. The default is 
1600. 


k This option is used when backing up to a block-structured dev- 
ice, such as a floppy disk. The size (in K-bytes) of the volume 
being written is taken from the next argument. If the k argu- 
ment is specified, any s and d arguments are ignored. The 
default is to use s and d. 


If no arguments are given, the key is assumed to be 9u and a default 
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file system is backed up to the default device. 


The first backup should be a full level-O backup: 


dump Ou 
Next, periodic level 9 backups should be made on an exponential 
progression of tapes or floppies: 


dump 9u 


(This is sometimes called the Tower of Hanoi progression after the 
name of the game where a similar progression occurs, i.e., 12131 
214... where backup 1 is used every other time, backup 2 every 
fourth, backup 3 every eighth, etc.) When the level-9 incremental 
backup becomes unmanageable because a tape is full or too many 
floppies are required, a level-1 backup should be made: 


dump lu 


After this, the exponential series should progress as if uninterrupted. 
These level-9 backups are based on the level-1 backup, which is 
based on the level-0 full backup. This progression of levels of back- 
ups can be carried as far as desired. 


The default file system and the backup device depend on the settings 
YY of the variables DISK and TAPE, respectively, in the file 
/etc /default/dump. 
Files 
/etc/ddate Records backup dates of file system /level 


etc/default/dump Default dump information 
See Also 


XENIX Operations Gutde 
cpio(C), default(M), dumpdir(C), restor(C), dump(F) 


— 
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Diagnostics 
If the backup requires more than one volume (where a volume is 


likely to be a floppy disk or tape), you will be asked to change 
volumes. Press RETURN after changing volumes. 


Notes 


Sizes are based on 1600 BPI for blocked tape; the raw magnetic tape 
device has to be used to approach these densities. Write errors to 
the backup device are usually fatal. Read errors on the file system 
are ignored. 


Warning 


When backing up to floppy disks, be sure to have enough formatted 
floppies ready before starting a backup. 
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Name 


dumpdir — Prints the names of files on a backup archive. 


Syntax 


dumpdir [ f filename | 


Description 
Dumpdtr is used to list the names and inode numbers of all files and 
directories on an archive written with the dump command. This is 
most useful when attempting to determine the location of a particu- 
lar file in a set of backup archives. 
The f option causes filename to be used as the name of the backup 


device instead of the default. The backup device depends on the 
setting of the variable TAPE in the file /etc/default/dump. 


Files 


rst* Temporary files 


\Y See Also 


dump(C), restor(C), default(M) 


Diagnostics 


If the backup extends over more than one volume (where a volume 
is likely a floppy disk or tape), you will be asked to change volumes. 
Press RETURN after changing volumes. 
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Name 


echo — Echoes arguments. 


Syntax 
echo[-n][-e][-u][- - ] [are]... ry 


Description 


Echo writes its arguments separated by blanks and terminated by a 
newline on the standard output. The following options are recog- 
nized: 


n Prints line without a newline. 


e Prints arguments on the standard error output. 


u Uses unbuffered I/O when printing. 


Prints arg exactly so that an argument beginning with a dash 
(e.g., — e or — n) can be specified. 


Echo also understands C-like escape conventions. The following 
escape sequences need to be quoted so that the shell interprets them 
correctly: 


\b Backspace 

\c_ Prints line without newline; same as use of — n option 
\f Form feed 

\n Newline 

\r Carriage return 

\t Tab 

\\ Backslash 


\n The 8-bit character whose ASCII code is the 1-, 2- or 3-digit 
octal number n, which must start with a zero 


Echo is useful for producing diagnostics in command files and for 
sending known data into a pipe. 


See Also 


sh( C) o 
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Name 


ed — Invokes the text editor. 


Syntax 


ed[- ][-x] | file ] 


Description 


Ed is the standard text editor. If the fle argument is given, ed 
simulates an e command (see below) on the named file; that is to 
say, the file is read into ed’s buffer so that it can be edited. The 
optional — suppresses the printing of character counts by e, r, and w 
commands, of diagnostics from e and g commands, and of the ! 
prompt after a !ehell command. If — x is present, an z command is 
simulated first to handle an encrypted file. Ed operates on a copy of 
the file it is editing; changes made to the copy have no effect on the 
file until a w (write) command is given. The copy of the text being 
edited resides in a temporary file called the buffer. There is only one 
buffer. 


Commands to ed have a simple and regular structure: zero, one, or 
two addresses followed by a single-character command, possibly fol- 
lowed by parameters to that command. These addresses specify one 
or more lines in the buffer. Every command that requires addresses 
has default addresses, so that the addresses can very often be omit- 
ted. 


In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in 
input mode. In this mode, no commands are recognized; all input is 
merely collected. Input mode is left by typing a period (.) alone at 
the beginning of a line. 


Ed supports a limited form of regular erpresston notation; regular 
expressions are used in addresses to specify lines and in some com- 
mands (e.g., 8) to specify portions of a line that are to be substi- 
tuted. A regular expression specifies a set of character strings. A 
member of this set of strings is said to be matched by the regular 
expression. The regular expressions allowed by ed are constructed 
as follows: 


YY The following one-character regular expressions match a single char- 


acter: 


1.1 An ordinary character (not one of those discussed in 1.2 
below) is a one-character regular expression that matches 
itself. 


March 24, 1984 Page 1 


ED (C) ED (C) 


1.2 <A backslash (\) followed by any special character is a one- 
character regular expression that matches the special character 
itself. The special characters are: 


a. ., *, [, and \ (dot, star, left square bracket, and backslash, 
respectively), which are always special, ercept when they 
appear within square brackets ([]; see 1.4 below). 


b. ~* (caret), which is special at the beginning of an entire 
regular expression (see 3.1 and 3.2 below), or when it 


immediately follows the left of a pair of square brackets 
([]) (see 1.4 below). 


c. $ (dollar sign), which is special at the end of an entire reg- 
ular expression (see 3.2 below). 


d. The character used to bound (i.e., delimit) an entire regu- 
lar expression, which is special for that regular expression 
(for example, see how slash (/) is used in the g com- 
mand, below.) 


1.3. A period (.) is a one-character regular expression that matches 
any character except newline. 


1.4 A nonempty string of characters enclosed in square brackets 
([]) is a one-character regular expression that matches any one 
character in that string. If, however, the first character of the 
string is a caret (%~), the one-character regular expression 
matches any character ercept newline and the remaining char- 
acters in the string. The star (*) has this special meaning only 
if it occurs first in the string. The dash (— ) may be used to 
indicate a range of consecutive ASCII characters; for example, 
[O— 9] is equivalent to [0123456789]. The dash (— ) loses this 
special meaning if it occurs first (after an initial caret ( ~), if 
any) or last in the string. The right square bracket (]) does 
not terminate such a string when it is the first character within 
it (after an initial caret (*), if any); e.g., []a- f] matches 
either a right square bracket (]) or one of the letters ‘‘a’’ 
through ‘‘f’’ inclusive. Dot, star, left bracket, and the 
backslash lose their special meaning within such a string of 
characters. 


The following rules may be used to construct regular expressions 
from one-character regular expressions: 


2.1 A one-character regular expression matches whatever the 
one-character regular expression matches. 


2.2 <A one-character regular expression followed by a star (*) is a 
regular expression that matches zero or more occurrences of 
the one-character regular expression. If there is any choice, 
the longest leftmost string that permits a match is chosen. 
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2.3 A one-character regular expression followed by \{m\}, \{m, \}, 
or \{m,n\} is a regular expression that matches a range of 
occurrences of the one-character regular expression. The 
values of m and n must be nonnegative integers less than 256; 
\{m\} matches ezactly m occurrences; \{m,\} matches at least 
m occurrences; \{m,n\} matches any number of occurrences 
between m and n, inclusive. Whenever a choice exists, the 
regular expression matches as many occurrences as possible. 


to 
ren 


The concatenation of regular expressions is a regular expres- 
sion that matches the concatenation of the strings matched by 
each component of the regular expression. 


2.5 <A regular expression enclosed between the character sequences 
\( and \) is a regular expression that matches whatever the 
unadorned regular expression matches. See 2.6 below for a 
discussion of why this is useful. 


2.6 The expression \n matches the same string of characters as 
was matched by an expression enclosed between \( and \) ear- 
lier in the same regular expression. Here n is a digit; the 
subexpression specified is that beginning with the n-th 
occurrence of \( counting from the left. For example, the 
expression “\(.*\)\1$ matches a line consisting of two 
repeated appearances of the same string. 


Finally, an entire regular expression may be constrained to match only 
an initial segment or final segment of a line (or both): 


3.1 <A caret (*) at the beginning of an entire regular expression 
constrains that regular expression to match an tnttal segment 
of a line. 


3.2 <A dollar sign ($) at the end of an entire regular expression 
constrains that regular expression to match a final segment of 
a line. The construction “entire regular ezpression$ constrains 
the entire regular expression to match the entire line. 


The null regular expression (e.g., //) is equivalent to the last regular 
expression encountered. 


To understand addressing in ed it is necessary to know that there is a 
current line at all times. Generally speaking, the current line is the 


last line affected by a command; the exact effect on the current line 
is discussed under the description of each command. Addresses are 


orn constructed as follows: 
1. The character . addresses the current line. 


2. The character $ addresses the last line of the buffer. 


3. A decimal number n addresses the n-th line of the buffer. 
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4. ‘zg addresses the line marked with the mark name character z, 
which must be a lowercase letter. Lines are marked with the k 
command described below. 


5. A regular expression enclosed by slashes (/) addresses the 
first line found by searching forward from the line following the 
current line toward the end of the buffer and stopping at the 
first line containing a string matching the regular expression. 
If necessary, the search wraps around to the beginning of the 
buffer and continues up to and including the current line, so 
that the entire buffer is searched. 


6. A regular expression enclosed in question marks (?) addresses 
the first line found by searching backward from the line preced- 
ing the current line toward the beginning of the buffer and 
stopping at the first line containing a string matching the regu- 
lar expression. If necessary, the search wraps around to the 
end of the buffer and continues up to and including the 
current line. See also the last paragraph before Files below. 


7. An address followed by a plus sign (+) or a minus sign (— ) 
followed by a decimal number specifies that address plus or 
minus the indicated number of lines. The plus sign may be 
omitted. 


8. If an address begins with + or — , the addition or subtraction 
is taken with respect to the current line; e.g, — 5 is understood ‘ 
to mean .— 5. 

9. If an address ends with + or — , then 1 is added to or sub- 
tracted from the address, respectively. As a consequence of 
this rule and of rule 8 immediately above, the address — 
refers to the line preceding the current line. (To maintain 
compatibility with earlier versions of the editor, the character 
“ in addresses is entirely equivalent to — .) Moreover, trailing 
+ and-— characters have a cumulative effect, so — — refers to 
the current line less 2. 


10. For convenience, a comma (,) stands for the address pair 1,$, 
while a semicolon (;) stands for the pair .,$. 


Commands may require zero, one, or two addresses. Commands 
that require no addresses regard the presence of an address as an 
error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if more 
addresses are given than such a command requires, the last 
address(es) are used. 


Typically, addresses are separated from each other by a comma (,). 
They may also be separated by a semicolon (;). In the latter case, 
the current line (.) is set to the first address, and only then is the 
second address calculated. This feature can be used to determine 
the starting line for forward and backward searches (see rules 5 and 
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6 above). The second address of any two-address sequence must 
correspond to a line that follows, in the buffer, the line correspond- 
ing to the first address. 


In the following list of ed commands, the default addresses are 


shown in parentheses. The parentheses are not part of the address; 
they show that the given addresses are the default. 


It is generally illegal for more than one command to appear on a 
line. However, any command (except e, f, r, or w) may be suffixed 
by por by ], in which case the current line is either printed or listed, 
respectively, as discussed below under the p and ! commands. 


(.)a 
<text> 


The append command reads the given text and appends it after 
the addressed line; dot is left at the last inserted line, or, if there 
were no inserted lines, at the addressed line. Address 0 is legal 
for this command: it causes the ‘‘appended”’ text to be placed at 
the beginning of the buffer. 


(.)e 


<text> 


The change command deletes the addressed lines, then accepts 
input text that replaces these lines; dot is left at the last line 
input, or, if there were none, at the first line that was not 


deleted. 


eee 
The delete command deletes the addressed lines from the 
buffer. The line after the last line deleted becomes the current 
line; if the lines deleted were originally at the end of the buffer, 
the new last line becomes the current line. 


e file 
The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; dot is set to the 
last line of the buffer. If no filename is given, the currently 
remembered filename, if any, is used (see the f command). 
The number of characters read is typed; file is remembered for 
possible use as a default filename in subsequent e, r, and w 
commands. If file begins with an exclamation (!), the rest of 
the line is taken to be a shell command. The output of this com- 
mand is read for the e and rcommands. For the w command, 


} the file is used as the standard input for the specified command. 
Such a shell command is not remembered as the current 
filename. 

E file 


The Edit command is like e, except the editor does not check to 
see if any changes have been made to the buffer since the last w 
command. 
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f file 
If file is given, the filename command changes the currently 
remembered filename to fle; otherwise, it prints the currently 
remembered filename. 


(1,$)g/regular-erpression/command list 

In the global command, the first step is to mark every line that 
matches the given regular expression. Then, for every such 
line, the given command list is executed with . initially set to that 
line. A single command or the first of a list of commands 
appears on the same line as the global command. All lines of a 
multiline list except the last line must be ended with a \; a, 1, 
and c commands and associated input are permitted; the . ter- 
minating input mode may be omitted if it would be the last line 
of the command list. An empty command list is equivalent to the 
p command. The g, G, v, and V commands are not permitted 
in the command list. See also Notes and the last paragraph before 
Files below. 


(1,$)G/regular-ezpression / 
In the interactive Global command, the first step is to mark 
every line that matches the given regular expression. Then, for 
every such line, that line is printed, dot (.) is changed to that 
line, and any one command (other than one of the a, c¢, t, g, G, 
v, and V commands) may be input and is executed. After the 
execution of that command, the next marked line is printed, 
and so on; a newline acts as a null command; an ampersand ( &) ‘y 
causes the re-execution of the most recent command executed 
within the current invocation of G. Note that the commands 
input as part of the execution of the G command may address 
and affect any lines in the buffer. The G command can be ter- 
minated by typing an INTERRUPT. 


h 
The help command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 
The Help command causes ed to enter a mode in which error 
messages are printed for all subsequent ? diagnostics. It will 
also explain the previous diagnostic if there was one. The H 
command alternately turns this mode on and off; it is initially 
on. 

(.)i 

<text> 


The tnsert command inserts the given text before the addressed vy 
line; dot is left at the last inserted line, or if there were no 
inserted lines, at the addressed line. This command differs from 
the a command only in the placement of the input text. 
Address 0 is not legal for this command. 
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+1)j 


The join command joins contiguous lines by removing the 
appropriate newline characters. If only one address is given, this 
command does nothing. 


(.)kz 


The mark command marks the addressed line with name gz, 
which must be a lowercase letter. The address ’z then addresses 
this line; dot is unchanged. 


)I 


The list command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting 
characters are printed in octal, and long lines are folded. An / 
command may be appended to any command other than e, f, r, 
or w. 


.)ma 


The move command repositions the addressed line(s) after the 
line addressed by a. Address 0 is legal for a and causes the 
addressed line(s) to be moved to the beginning of the file; it is 
an error if address a falls within the range of moved lines; dot is 
left at the last line moved. 


.)n 


The number command prints the addressed lines, preceding 
each line by its line number and a tab character; dot is left at the 
last line printed. The n command may be appended to any com- 
mand other than e, f, r, or w. 


.)P 


The print command prints the addressed lines; dot is left at the 
last line printed. The p command may be appended to any com- 
mand other than e, f, r, or w; for example, dp deletes the 
current line and prints the new current line. 


P 
The editor will prompt with a * for all subsequent commands. 
The P command alternately turns this mode on and off; it is ini- 
tially on. 

q 
The quit command causes ed to exit. No automatic write of a 
file is done. 

Q on aw hy 
The editor exits without checking if changes have been made in 
the buffer since the last w command. 

($)r file 


The read command reads in the given file after the addressed 
line. If no filename is given, the currently remembered 


March 24, 1984 Page 7 


ED (C) 


ED (C) 


filename, if any, is used (see e and f commands). The currently 
remembered filename is not changed unless file is the very first 
filename mentioned since ed was invoked. Address 0 is legal for 
r and causes the file to be read at the beginning of the buffer. If 
the read is successful, the number of characters read is typed; 
dot is set to the last line read in. If file begins with !, the rest of 
the line is taken to be a shell (sh(C)) command whose output is 
to be read. Such a shell command is not remembered as the 
current filename. 


.)s/regular-erpression [replacement / 


Or 


.)s/regular-ezpression /replacement/g 


The substitute command searches each addressed line for an 
occurrence of the specified regular expression. In each line in 
which a match is found, all (nonoverlapped) matched strings are 
replaced by the replacement if the global replacement indicator g 
appears after the command. If the global indicator does not 
appear, only the first occurrence of the matched string is 
replaced. It is an error for the substitution to fail on all 
addressed lines. Any character other than space or newline may 
be used instead of / to delimit the regular expression and the 
replacement; dot is left at the last line on which a substitution 
occurred. 


An ampersand ( &) appearing in the replacement is replaced by 
the string matching the regular expression on the current line. 
The special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters \n, 
where n is a digit, are replaced by the text matched by the n-th 
regular subexpression of the _ specified regular expression 
enclosed between \( and \). When nested parenthesized subex- 
pressions are present, n is determined by counting occurrences 
of \( starting from the left. When the character %is the only 
character in the replacement, the replacement used in the most 
recent substitute command is used as the replacement in the 
current substitute command. The % loses its special meaning 
when it is in a replacement string of more than one character or 
is preceded by a \. 


A line may be split by substituting a newline character into it. 
The newline in the replacement must be escaped by preceding it 
with a \. Such a substitution cannot be done as part of ag or v 
command list. 


.)ta 


This command acts just like the m command, except that a copy 
of the addressed lines is placed after address a (which may be 
0); dot is left at the last line of the copy. 


The undo command nullifies the effect of the most recent com- 
mand that modified anything in the buffer, namely the most 
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recent a, c, d, g, t, 7, m, r, 8, t, v, G, or V command. 


(1,$)v/regular-erpression/command list 
This command is the same as the global command g except that 
the command list is executed with dot initially set to every line 


that does not match the regular expression. 
& (1,$)V/regular-erpression / 
This command is the same as the interactive global command G 


except that the lines that are marked during the first step are 
those that do not match the regular expression. 


(1,$)w file 

The write command writes the addressed lines into the named 
file. If the file does not exist, it is created with mode 666 (read- 
able and writeable by everyone), unless the umask setting (see 
sh(C)) dictates otherwise. The currently remembered filename 
is not changed unless file is the very first filename mentioned 
since ed was invoked. If no filename is given, the currently 
remembered filename, if any, is used (see e and f commands); 
dot is unchanged. If the command is successful, the number of 
characters written is displayed. If file begins with an exclama- 
tion (!), the rest of the line is taken to be a shell command to 
which the addressed lines are supplied as the standard input. 
Such a shell command is not remembered as the current 
filename. 


A key string is demanded from the standard input. Subsequent 
e, r, and w commands will encrypt and decrypt the text with this 
key by the algorithm of crypt(C). An explicitly empty key turns 
off encryption. 


($)= 
The line number of the addressed line is typed; dot is 
unchanged by this command. 


'shell command 
The remainder of the line after the ! is sent to the XENIX shell 
(sh(C)) to be interpreted as a command. Within the text of that 
command, the unescaped character % is replaced with the 
remembered filename; if a ! appears as the first character of the 
shell command, it is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell command. If any 
expansion is performed, the expanded line is echoed; dot is 
unchanged. 


(.+1) An address alone on a line causes the addressed line to be 
printed. A RETURN alone on a line is equivalent to .+1p. This 
is useful for stepping forward through the editing buffer a line at 
a time. 
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If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a 
question mark (?) and returns to its command level. 


Some size limitations: 512 characters per line, 256 characters per glo- 


bal command list, 64 characters per filename, and 128K characters in 
the buffer. The limit on the number of lines depends on the amount ‘ry 


of user memory. 


When reading a file, ed discards ASCII NUL characters and all charac- 
ters after the last newline. Files that contain characters not in the 
ASCII set (bit 8 on) cannot be edited by ed. 


If the closing delimiter of a regular expression or of a replacement 
string (e.g., /) would be the last character before a newline, that del- 
imiter may be omitted, in which case the addressed line is printed. 
Thus the following pairs of commands are equivalent: 


s/s1/s2s/s1/s2/p 
g/sig/s1/p 
?sl?sl? 


Files 


/tmp/e# Temporary; # is the process number 


ed.hup Work is saved here if the terminal is hung up ‘> 


See Also 


crypt(C), grep(C), sed(C), sh(C) 


Diagnostics 


? Command errors 
? fle An inaccessible file 


Use the help and Help commands for detailed explanations. 


If changes have been made in the buffer since the last w command 
that wrote the entire buffer, ed warns the user if an attempt is made 
to destroy ed’s buffer via the e or g commands: it prints ? and 
allows you to continue editing. A second e or g command at this 


point will take effect. The dash (— ) command-line option inhibits ry 


this feature. 


Notes 


An exclamation (!) command cannot be subject to a g or a v com- 
mand. 
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The ! command and the ! escape from the e, r, and w commands 
cannot be used if the the editor is invoked from a restricted shell 


(see sh(C)). 


The sequence \n in a regular expression does not match any charac- 


& ter. 
The ! command mishandles DEL. 


Files encrypted directly with the crypt(C) command with the null key 
cannot be edited. 


Because 0 is an illegal address for the w command, it is not possible 
to create an empty file with ed. 
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Name 


enable — Turns on terminals. 


Syntax 


enable [— d] [ [ — e] tty ... ry 


Description 


This program manipulates the /etc/ttys file and signals init to allow 
logins on a particular terminal. The — e and — d options may be 
used to allow logins on some terminals and disallow logins on other 
terminals in a single command. 
Examples 
A simple command to enable tty01 follows: fi 
enable tty01 
Multiple terminals can be disabled or enabled using the — d and — e 
switches before the appropriate terminal name: 
enable ttyO0l — e tty02 — d tty03 tty04 ‘> 
Files 
/dev /tty* 


/etc/ttys 


See Also 


login(M), disable(C), ttys(M), getty(M), init(M) 


Warning 


Be absolutely certain to pause at least one minute before reusing this 
command or before using the disable command. Failure to do so 


may cause the system to crash. ry 
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Name 


env — Sets environment for command execution. 


Syntax 


env [— ] [ name=value ] ... [ command args ] 


Description 


Env obtains the current environment, modifies it according to its 
arguments, then executes the command with the modified environ- 
ment. Arguments of the form name=value are merged into the 
inherited environment before the command is executed. The — flag 
causes the inherited environment to be ignored completely, so that 
the command is executed with exactly the environment specified by 
the arguments. 


If no command is specified, the resulting environment is printed, 
one name-value pair per line. 


See Also 


&Y sh(C), exec(S), profile(M), environ(M) 
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ex — Invokes a text editor. 


Syntax 


ex[-— ][-—v][-—ttag][-r] [ +lhneno] name... oe 


Description 


Ez is the root of the editors ez and us. Ez is a superset of ed, whose 
most notable extension is a display editing facility. Display based 
editing is the focus of v1. 


If you have not used ed, or if you are a casual user, you will find 
that edit is most convenient for you. It avoids some of the complexi- 
ties of ez which is used mostly by systems programmers and persons 
very familiar with ed. 


If you have a CRT terminal, you may wish to use a display based edi- 
tor; in this case see vt(C), a command which focuses on the display 
editing portion of ez. 


For ed Users ‘> 


If you have used ed you will find that ez has a number of new 
features. Intelligent terminals and high-speed terminals are very 
pleasant to use with wt. Generally, the ez editor uses far more of the 
capabilities of terminals than ed does. It uses the terminal capability 
database termcap(M) and the type of the terminal you are using 
from the variable TERM in the environment to determine how to 
drive your terminal efficiently. The ez editor makes use of features 
such as insert and delete character and line in its visual command 
mode, which can be abbreviated vi , and which is the central mode 
of editing when using w(C). There is also an interline editing open 
command, (o) that works on all terminals. 


Er contains a number of features for easily viewing the text of a file. 
The z command gives easy access to windows of text. Hitting 
CNTRL-D causes the editor to scroll a half-window of text and is 
more useful for quickly stepping through a file than just hitting the 
RETURN key. Of course, the screen-oriented visual mode gives 
constant access to editing context. 


Ez gives you more help when you make mistakes. The undo (u) ry 
command allows you to reverse any single change. Ez gives you a lot 


of feedback, normally printing changed lines, and indicates when 
more than a few lines are affected by a command so it is easy to 
detect when a command has affected more lines than it should have. 
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The editor also normally prevents the overwriting of existing files 
unless you have edited them, so that you don’t accidentally clobber 
with a wnte a file other than the one you are editing. If the system 
(or editor) crashes, or you accidentally hang up the phone, you can 
use the recover command to retrieve your work. This will get you 
YY back to within a few lines of where you left off. 

Ez has several features for editing more than one file atatime. You 
can give it a list of files on the command line and use the next (n) 
command to edit each in turn. You can also give the next command 
a list of filenames, or a pattern used by the shell to specify a new set 
of files to be edited. In general, filenames in the editor may be 
formed with full shell metasyntax. The metacharacter ‘'%’’ is also 
available in forming filenames and is replaced by the name of the 
current file. For editing large groups of related files you can use ez’s 
tag command to quickly locate functions and other important points 
in any of the files. This is useful when you want to find the 


definition of a particular function in a large program. The command 
ctaga(CP) builds a tage file or a group of C programs. 


For moving text between files and within a file, the editor has a 
group of buffers named a through z. You can place text in these 
named buffers and carry it over when you edit another file. 


The command & repeats the last substitute command. There is also 
a confirmed substitute command. You give a range of substitutions 
to be done and the editor interactively asks whether each substitu- 
tion is desired. 


You can use the substitute command in ez to systematically convert 
the case of letters between uppercase and lowercase. It is possible to 
ignore case in searches and substitutions. Ez also allows regular 
expressions that match words to be constructed. This is convenient, 
for example, when searching for the word ‘“‘edit’’ if your document 
also contains the word ‘‘editor.”’ 


Er has a set of options that you can set. One option which is very 
useful is the autoindent option that allows the editor to automatically 
supply leading white space to align text. You can then use the 
CNTRL-D key to backtab, space and tab forward to align new code 
easily. 


Miscellaneous new useful features include an intelligent join (j) 
command which supplies whitespace between joined lines automati- 
cally, the commands < and > which shift groups of lines, and the 


YY ability to filter portions of the buffer through commands such as sort. 
Files 
/usr/lib/ex2.Ostrings Error messages 
/usr/lib/ex2.0recover Recover command 
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/usr/lib/ex2.0preserve Preserve command 
/etc/termcap Describes capabilities of terminals 
$HOME/.exrc Editor startup file 
/tmp/Exnnnnn Editor temporary ry 
/tmp/Rxnnnnn Named buffer temporary 
/usr/preserve Preservation directory 

See Also 


awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(M), vi(C) 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 


The undo command causes all marks to be lost on lines changed and a 


then restored if the marked lines were changed. 
Undo never clears the buffer modified condition. 


The z command prints a number of logical rather than physical lines. 
More than a screen full of output may result if long lines are 
present. 


File input/output errors don’t print a name if the command line 
‘*_ ** option is used. 


There is no easy way to do a single scan ignoring case. 


Because of the implementation of the arguments to nezt, only 512 
bytes of argument list are allowed there. 


The format of /etchermcap and the large number of capabilities of 
terminals used by the editor cause terminal type setup to be rather 
slow. 


The editor does not warn if text is placed in named buffers and not ry 
used before exiting the editor. 


Null characters are discarded in input files and cannot appear in 
resultant files. 
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Name 


expr— Evaluates arguments as an expression. 


Syntax 


expr arguments 


Description 


The arguments are taken as an expression. After evaluation, the 
result is written on the standard output. Terms of the expression 
must be separated by blanks. Characters special to the shell must be 
escaped. Note that zero is returned to indicate a zero value, rather 
than the null string. Strings containing blanks or other special char- 
acters should be quoted. Integer-valued arguments may be preceded 
by a unary minus sign. Internally, integers are treated as 32-bit, 2’s 
complement numbers. 


The operators and keywords are listed below. Expressions should be 
quoted by the shell, since many of the characters that have special 
meaning in the shell also have special meaning in ezpr. The list is in 
order of increasing precedence, with equal precedence operators 
grouped within braces ( { and }). 


expr | expr 
Returns the first ezpr if it is neither null nor 0, otherwise 
returns the second ezpr. 


erpr & ezrpr 
Returns the first ezpr if neither ezpr is null nor 0, otherwise 
returns Q. 


exzpr{ =, 2a, >= <<, <=> !== } expr 
Returns the result of an integer comparison if both argu- 
ments are integers, otherwise returns the result of a lexical 
comparison. 


expr{+,-— }egpr 
Addition or subtraction of integer-valued arguments. 


crepe t*./, 20} ezpr 
Multiplication, division, or remainder of the integer-valued 


5 arguments. 
erpr: ezpr 


The matching operator : compares the first argument with 
the second argument which must be a regular expression; 
regular expression syntax is the same as that of ed(C), 
except that all patterns are ‘‘anchored”’ (i.e., begin with a 
caret (*)) and therefore the caret is not a special character 
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in that context. (Note that in the shell, the caret has the 
same meaning as the pipe symbol { |).) Normally the match- 
ing operator returns the number of characters matched 
(zero on failure). Alternatively, the \(...\) pattern sym- 
bols can be used to return a portion of the first argument. 


Ex amples ry 


1. a= ‘expr $a + 1* 


Adds 1 to the shell variable a. 


2. # For $a equal to either ”/usr/abc/file” or just ”/file” 
exproSa cicVVoy pba’ 


Returns the last segment of a pathname (i.e., file). Watch 
out for the slash alone as an argument: ezpr will take it as 
the division operator (see Notes below). 


S. texpro¢VAn 2 


Returns the number of characters in $VAR. 


See Also ‘> 
ed(C), sh(C) 


Diagnostics 


As a side effect of expression evaluation, erpr returns the following 
exit values: 


0 If the expression is neither null nor zero 
1 If the expression is null or zero 
2 For invalid expressions 


Other diagnostics include: 
syntaz error For operator/operand errors 


nonnumeric argument If arithmetic is attempted on such a string 
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Notes 
After argument processing by the shell, ezpr cannot tell the 
difference between an operator and an operand except by the value. 


If $a is an equals sign (=), the command: 


expr $a = = 


looks like: 


expr —_—- at — a ——} 


Thus the arguments are passed to ezpr (and will all be taken as the 
= operator). The following permits comparing equals signs: 


espr Mea = X= 
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Name 


false — Returns with a nonzero exit value. 


Syntax 


false ry 


Description 


False does nothing except return with a nonzero exit value. 
True(C), false’s counterpart, does nothing except return with a zero 
exit value. False is typically used in shell procedures such as: 


until false 
do 


command 
done 


See Also 


sh(C), true(C) 


Diagnostics 


False has exit status 1. 
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Name 


file - Determines file type. 


Syntax 
file [— m] file ... 


file [— m] — f namesfile 


Description 


File performs a series of tests on each argument in an attempt to 
classify it. If an argument appears to be ASCII, fle examines the 
first 512 bytes and tries to guess its language. 


If the —f option is given, file takes the list of filenames from 
namesfile. If the — m option is given, file sets the access time for the 
examined file to the current time. Otherwise, the access time 
remains unchanged. 


Several object file formats are recognized. For a.out and x.out for- 
mat object files, the relationship of ce flags to file classification is — i 


& for ‘‘separate’’, — n for ‘‘pure’’, and — s for not ‘‘not stripped’’. 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 


It can make mistakes: in particular it often suggests that command 
files are C programs. 


L 
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Name 


FIND (C) 


find — Finds files. 


Syntax 


find pathname-list expression 


Description 


Find recursively descends the directory hierarchy for each pathname 
in the pathname-list (i.e., one or more pathnames) seeking files that 
match a Boolean ezpresston written in the primaries given below. In 
the descriptions, the argument n is used as a decimal integer where 


+n means more than n, — n means less than n, and n means 
exactly n. 
— name file True if file matches the current filename. Normal 


— perm onum 


— links n 


— user uname 


— group gname 


— size n 


— atime n 
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shell argument syntax may be used if escaped 
(watch out for the left bracket ([), the question 
mark (?) and the star (*)). 


True if the file permission flags exactly match the 
octal number onum (see chmod(C)). If onum is 
prefixed by a minus sign, more flag bits (017777, 
see stat(S)) become significant and the flags are 
compared: 


( flags&onum) ==onum 


True if the type of the file is z, where z is bfor a 
block special file, c for a character special file, d for 
a directory, pfor a named pipe, f for a plain file, or 
n for asemaphore or shared data file. 


True if the file has n links. 


True if the file belongs to the user uname. If 
uname is numeric and does not appear as a login 
name in the /etc/passwd file, it is taken as a user 
ID. 


True if the file belongs to the group gname. If 
gname is numeric and does not appear in the 


/etc/group file, it is taken as a group ID. 


True if the file is n blocks long (512 bytes per 
block). 


True if the file has been accessed in n days. 
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— mtime n 
— ctime n 


— exec cmd 


— ok cmd 


— print 


— newer file 


( expression ) 


FIND (C) 


True if the file has been modified in n days. 
True if the file has been changed in n days. 


True if the executed cmd returns a zero value as 
exit status. The end of cmd must be punctuated by 
an escaped semicolon. A command argument {} is 
replaced by the current pathname. 


Like — exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y. 


Always true; causes the current pathname to be 
printed. 


True if the current file has been modified more 
recently than the argument file. 


True if the parenthesized expression is_ true 
(parentheses are special to the shell and must be 
escaped). 


The primaries may be combined using the following operators (in 
order of decreasing precedence): 


negation 


The negation of a primary is specified with the exclamation (!) 


unary not operator. 


AND 


The AND operation is implied by the juxtaposition of two pri- 


maries. 


OR The OR operation is specified with the —o operator given 
between two primaries. 


Ex amples 


The following removes all files named a.out or *.o that have not 
been accessed for a week: 


find / \( - name aout - o — name ’*.o’ \) — atime +7 —- exec rm 


{hs 


— 


wy Files 


/etc/passwd 


/etc/group 
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See Also 


cpio(C), sh(C), test(C), stat(S), cpio(F) 
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Name 


finger — Finds information about users. 


Syntax 


finger [ -bfilpqsw | [login1 [login2 ...] | 


Description 


By default finger lists the login name, full name, terminal name and 
write status (as a ‘‘*’’ before the terminal name if write permission 
is denied), idle time, login time, and office location and phone 
number (if they are known) for each current XENIX user. (Idle time 
is minutes if it is a single integer, hours and minutes if a colon (:) is 
present, or days and hours if a ‘‘d’’ is present.) 


A longer format also exists and is used by finger whenever a list of 
names is given. (Account names as well as first and last names of 
users are accepted.) This is a multiline format; it includes all the 
information described above as well as the user’s home directory and 
login shell, any plan which the person has placed in the file .plan in 
their home directory, and the project on which they are working 
from the file .project also in the home directory. 


Finger options are: 

— b Briefer long output format of users. 

— f Suppresses the printing of the header line (short format) 
— 1 Quick list of users with idle times. 

— 1 Forces long output format. 

— p Suppresses printing of the .plan files. 


q Quick list of users. 


— s Forces short output format. 


— Ww 
mI Forces narrow format list of specified users. 
w Files 
/etc/utmp Who file 
/etc/passwd User names, offices, phones, 
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login directories, and shells 


/usr/adm /lastlog Last login times 

$HOME/.plan Plans 

$HOME/.project Projects ry 
See Also 

who(C) 
Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 
Only the first line of the .project file is printed. 
The ‘‘office’’ column of the output will contain any text in the com- 
ment field of the user’s /etc/passwd file entry that immediately fol- 
lows acomma(,). For example, if the entry is fy 
johnd:eX8HinAk:201:50:John Doe, 321:/usr/johnd:/bin/sh 
the number 321 will appear in the office column. 
Idle time is computed as the elapsed time since any activity on the 
given terminal. This includes previous invocations of finger which 


may have modified the terminal’s corresponding device file 
/dev /tty? ?. 


March 26, 1984 Page 2 


FSCK (C) FSCK (C) 


Name 


fsck — Checks and repairs file systems. 


Syntax 


/etc/fsck | options | [ file-system ] ... 


Description 


Fsck audits and interactively repairs inconsistent conditions for 
XENIX file systems, whether XENIX version 2.3 cr 3.0. If the file sys- 
tem is consistent then the number of files, number of blocks used, 
and number of blocks free are reported. If the file system is incon- 
sistent the operator is prompted for concurrence before each correc- 
tion is attempted. It should be noted that most corrective actions 
result in some loss of data. The amount and severity of the loss 
may be determined from the diagnostic output. The default action 
for each consistency correction is to wait for the operator to respond 
‘‘ves’’ or ‘‘no’’. If the operator does not have write permission feck 
defaults to the action of the — n option. 


The following flags are interpreted by feck: 


—y Assumes a yes response to all questions asked by fack. 


—n Assumes ano response to all questions asked by feck; do not 
open the file system for writing. 


— sb:e 
Ignores the actual free list and (unconditionally) reconstructs 
a new one by rewriting the super-block of the file system. The 
file system must be unmounted while this is done. 


The — sb:e:c option allows for creating an optimal free-list 
organization. The following forms are supported: 


-— s 
~— sBlocks-per-cylinder:Blocks-to-skip (for anything else) 


If b:c is not given, then the values used when the file system 
was created are used. If these values were not specified, then 
a reasonable default value is used. 


\& —~ S$ Conditionally reconstructs the free list. This option is like 


— sb:c above except that the free list is rebuilt only if there 
are no discrepancies discovered in the file system. Using — § 
forces a ‘‘no’’ response to all questions asked by feck. This 
option is useful for forcing free list reorganization on uncon- 


taminated file systems. 
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—t If feck cannot obtain enough memory to keep its tables, it 
uses a scratch file. If the — t option is specified, the file named 
in the next argument is used as the scratch file, if needed. 
Without the — t flag, feck prompts the operator for the name 
of the scratch file. The file chosen should not be on the file 
system being checked, and if it is not a special file or did not 
already exist, it is removed when feck completes. 


—rr Recovers the root file system. The required filesystem argu- 
ment must refer to the root file system, and preferably to the 
block device (normally /dev/root .) This switch implies — y 
and overrides — n. If any modifications to the file system are 
required, the system will be automatically shutdown to insure 
the integrity of the file system. 


—c Causes any supported file system to be converted to the type 
of the current file system. The user is asked to verify the 
request for each file system that requires conversion unless 
the — y option is specified. It is recommended that every file 
system be checked with this option, while unmounted if it is to 
be used with the current version of XENIX. To update the 
active root file system, it should be checked with: 


fsck — c — rr /dev/root 


If no file systems are specified, feck reads a list of default file systems 
from the file /etc/checklist. 


Inconsistencies checked are as follows: 
— Blocks claimed by more than one inode or the free list 


— Blocks claimed by an inode or the free list outside the range of 
the file system 


~ Incorrect link counts 
= Size checks: 


Incorrect number of blocks 
Directory size not 16-byte aligned 


Bad inode format 
Blocks not accounted for anywhere 


Directory checks: 
File pointing to unallocated inode 
Inode number out of range 
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Super-block checks: 
More than 65536 inodes 
More blocks for inodes than there are in the file system 


& Bad free block list format 


Total free block or free inode count incorrect 


Orphaned files and directories (allocated but unreferenced) are, with 
the operator's concurrence, reconnected by placing them in the 
lost+ found directory. The name assigned is the inode number. The 
only restriction is that the directory lost+found must preexist in the 
root of the file system being checked and must have empty slots in 
which entries can be made. This is accomplished by making 
lost+ found, copying a number of files to the directory, and then 
removing them (before fsck is executed). 


Files 


/etc/checklist Contains default list of file systems to check 


See Also 


checklist(F), filesystem(F) 


Diagnostics 


The diagnostics produced by fsck are intended to be self-explanatory. 


Notes 


Fsck will not run on a mounted non-raw file system unless the file 
system is the root file system or unless the — n option is specified 
and no writing out of the file system will take place.. If any such 
attempt is made, a warning is printed and no further processing of 
the file system is done for the specified device. 


Although checking a raw device is almost always faster, there is no 
way to tell if the file system is mounted. And cleaning a mounted 
file system will almost certainly result in an inconsistent superblock. 


Warning 


For a XENIX 2.3 file system to be properly supported under XENIX 
3.0, it is necessary that feck be run on each 2.3 file system to be 
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mounted under the XENIX 3.0 kernel. For the root file system, 
‘fsck — rr /dev/root’’ should be run and for all other file systems 
“fsck /dev/??’’ on the unmounted block device should be used. 
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Name 


getopt — Parses command options. 


Syntax 


set — — ‘getopt optstring $** 


Description 


Getopt is used to check and break up options in command lines for 
parsing by shell procedures. Optstring is a string of recognized 
option letters (see getopt(S)). If a letter is followed by a colon, the 
option is expected to have an argument which may or may not be 
separated from it by whitespace. The special option — — is used to 
delimit the end of the options. Getopt will place — — in the argu- 
ments at the end of the options, or recognize it if used explicitly. 
The shell arguments ($1 $2...) are reset so that each option is pre- 
ceded by a dash (— ) and in its own shell argument; each option 
argument is also in its own shell argument. 


Example 


The following code fragment shows how one can process the argu- 
ments for a command that can take the options a and b, and the 
option o, which requires an argument: 


set - -— ‘getopt abo: $** 

Hol Si fe 05] 

then 
echo $USAGE 
exit 2 

fi 

for i in $* 

do 
case $i in 
-~a]|-b) FLAG=$i; shift;; 
- 0) OARG=$2; © shift; shift;; 
- —) shift; break;; 
esac 

done 


This code will accept any of the following as equivalent: 


emd — aoarg file file 

cmd — a-— o arg file file 
cmd — oarg — a file file 

cmd — a — oarg — — file file 
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See Also 


sh(C), getopt(S) 


Diagnostics 


Getopt prints an error message on the standard error when it ry 


encounters an option letter not included in optstring. 
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Name 


GREP (C) 


grep, egrep, fgrep — Searches a file for a pattern. 


Syntax 


grep | 


options | expression [ files | 


egrep [ options | [ expression ] [ files | 


fgrep [ options | [ strings | | files ] 


Description 


Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is 
copied to the standard output. Grep patterns are limited regular 
expressions in the style of ed(C); it uses a compact nondeterministic 
algorithm. Egrep patterns are full regular erpressions; it uses a fast 
deterministic algorithm that sometimes needs exponential space. 
Fgrep patterns are fixed strings; itis fast and compact. The following 
options are recognized: 


= ¥. 


ae 


All lines but those matching are printed. 
Prints only exact matches of an entire line. (Fgrep only.) 
Only a count of matching lines is printed. 


Only the names of files with matching lines are listed, 
separated by newlines. 


Prevents the name of the file containing the matching line 
from being appended to that line. Used when searching mul- 
tiple files. 


Each line is preceded by its relative line number in the file. 
Each line is preceded by the block number on which it was 
found. This is sometimes useful in locating disk block 


numbers by context. 


Suppresses error messages produced for nonexistent or 
unreadable files. 


Turns on matching of letters of either case in the input so that 
case is insignificant. Does not work for egrep. 


— e ezpression 


Same as a simple ezpresston argument, but useful when the 
expression begins with a dash (— ). 
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— f file 
The regular ezpression for grep or egrep, or strings list (for 
fgrep) is taken from the file. 


In all cases, the filename is output if there is more than one input 
file. Care should be taken when using the characters $, *, [, *, |, (, 
), and \ in ezpression, because they are also meaningful to the shell. 
It is safest to enclose the entire erpresston argument in single quota- 
tion marks. 


Fgrep searches for lines that contain one of the stnnge separated by 
newlines. 


Egrep accepts regular expressions as in ed(C), except for \( and \), 
with the addition of the following: 


— A regular expression followed by a plus sign (+) matches one 
or more occurrences of the regular expression. 


— A regular expression followed by a question mark (?) matches 0 
or 1 occurrences of the regular expression. 


— Two regular expressions separated by a vertical bar (}) or by a 
newline match strings that are matched by either regular expres- 
sion. 


— A regular expression may be enclosed in parentheses () for ‘y 


grouping. 


The order of precedence of operators is [], then *? +, then con- 
catenation, then the backslash (\) and the newline. 
See Also 


ed(C), sed(C), sh(C) 


Diagnostics 
Exit status is 0 if any matches are found, 1 if none, 2 for syntax 


errors or inaccessible files. 


Notes 


Ideally there should be only one grep, but there isn’t a single algo- ry 


rithm that spans a wide enough range of space-time tradeoffs. 


Lines are limited to 256 characters; longer lines are truncated. 


Egrep does not recognize ranges, such as [a~— 2z], in character classes. 
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When using grep with the — y option, the search is not made totally 
case insensitive in character ranges specified within brackets. 


Multiple strings can be specified in fgrep without using a separate 
strings file by using the quoting conventions of the shell to imbed 


YY newlines in the single string argument. For example, you might type 


the following at the command line: 


fgrep Stringl 
string2 
string3 ‘ text.file 


Similarly, multiple strings can be specified in egrep by doing: 
egrep String] tring2ptring3 ‘ text. file 


Thus egrep can do almost anything that grep and frep can do. 


WY 
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Name 


grpcheck — Checks group file. 


Syntax (ry 
pwcheck [ file] 


grpcheck [ file] 


Description 
Grpcheck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, and 


whether all login names appear in the password file. The default 
group file is /etc/group. 


Files 


/etc/group 


/etc/passwd 


See Also ry 


pwcheck(C), group(M), passwd(M) 


Diagnostics 


Group entries in /etc/group with no login names are flagged. 
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Name 


haltsys — Closes out the file systems and halts the CPU. 


Syntax 


/etc/haltsys 


Description 


Haltsys does a shutdn() system call (see shutdn(S)) to flush out 
pending disk I/O, mark the file systems clean, and halt the proces- 
sor. Haltsys takes effect immediately, so user processes should be 
killed beforehand. Shutdown(C) is recommended for normal system 
termination; it warns the users, cleans things up, and calls halteys. 
Use haltsys directly only if some system problem prevents the run- 
ning of shutdown. 


See Also 


shutdn(S), shutdown(C) 
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Name 


hd— Displays files in hexadecimal format. 


Syntax mY 
hd [ — format [ — s offset] [— n count ] | file ] ... ; 
Description 


The hd command displays the contents of files in hexadecimal, octal, 
decimal, and character formats. Control over the specification of 
ranges of characters is also available. The default behavior is with 
the following flags set: ‘‘- abx — A’’. This says that addresses (file 
offsets) and bytes are printed in hexadecimal and that characters are 
also printed. If no fle argument is given, the standard input is read. 


Options include: 


— s offset Specify the beginning offset in the file where printing is 
to begin. If no ‘file’ argument is given, or if a seek 
fails because the input is a pipe, ‘offset’ bytes are read 
from the input and discarded. Otherwise, a seek error 
will terminate processing of the current file. 


The offset may be given in decimal, hexadecimal (pre- 
ceded by ‘0Ox’), or octal (preceded by a ‘0’). It is 
optionally followed by one of the following multipliers: 
w, I, b, or k; for words (2 bytes), long words (4 bytes), 
blocks (512 bytes), or kbytes (1024 bytes). Note that 
this is the one case where ‘‘b’’ does not stand for bytes. 
Since specifying a hexadecimal offset in blocks would 
result in an ambiguous trailing ‘b’, any offset and mul- 
tiplier may be separated by an asterisk (*). 


— n count Specify the number of bytes to process. The count is in 
the same format as offset, above. 


Format Flags 


Format flags may specify addresses, characters, bytes, words (2 
bytes) or longs (4 bytes) to be printed in hex, decimal, or octal. 
Two special formats may also be indicated: text or ascil. Format and 
base specifiers may be freely combined and repeated as desired in 
order to specify different bases (hexadecimal, decimal or octal) for 
different output formats (addresses, characters, etc.). All format 
flags appearing in a single argument are applied as appropriate to all 
other flags in that argument. 
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acbwlA 
Output format specifiers for addresses, characters, bytes, words, 
longs and ascii respectively. Only one base specifier will be used 
for addresses; the address will appear on the first line of output 
that begins each new offset in the input. 


vv The character format prints printable characters unchanged, spe- 


cial C escapes as defined in the language, and the remaining 
values in the specified base. 


The ascii format prints all printable characters unchanged, and 
all others as a period (.). This format appears to the right of the 
first of other specified output formats. A base specifier has no 
meaning with the ascii format. If no other output format (other 
than addresses) is given, bx is assumed. If no base specifier is 
given, all of xdo are used. 


xdo Output base specifiers for hexadecimal, decimal and octal. If no 
format specifier is given, all of acbwl are used. 


t Print a text file, each line preceded by the address in the file. 
Normally, lines should be terminated by a \n character; but 
long lines will be broken up. Control characters in the range 
0x00 to OxlIf are printed as ‘°@’ to ‘*_’. Bytes with the high bit 
set are preceded by a tilde ( ) and printed as if the high bit were 
not set. The special charcters (*, ~, \) are preceded by a 
backslash (\) to escape their special meaning. As special cases, 
two values are represented numerically as ‘\177’ and ‘\377’. 
This flag will override all output format specifiers except 
addresses. 
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Name 


head — Prints the first few lines of a stream. 


Syntax 


head [ — count] | file ... | ry 


Description 


This filter prints the first count lines of each of the specified files. If 
no files are specified, head reads from the standard input. If no 
count is specified, then 10 lines are printed. 


See Also 


tail( C) 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 
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Name 


id — Prints user and group IDs and names. 


Syntax 


id 


Description 
Id writes a message on the standard output giving the user and 
group IDs and the corresponding names of the invoking process. If 
the effective and real IDs do not match, both are printed. 


See Also 


logname(C), getuid(S) 


y) 
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Name 


join — Joins two relations. 


Syntax 


join [ options ] filel file2 


Description 


Join forms, on the standard output, a join of the two relations 
specified by the lines of filef and file2. If file1 is a dash (— ), the 


standard input is used. 


File1 and fie2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be Joined, normally the first in 
each line. 


There is one line in the output for each pair of lines in file1 and file? 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from file1, then the rest 
of the line from /file2. 


Fields are normally separated by blank, tab or newline. In this case, 
multiple separators count as one, and leading separators are dis- 
carded. 


These options are recognized: 


— an In addition to the normal output, produces a line for each 
unpairable line in file n, where n is 1 or 2. 


—es8 Replaces empty output fields by string s. 


—~jnm Joins on the mth field of file n. If n is missing, uses the 
mth field in each file. 


— o list Each output line comprises the fields specifed in lst, each 
element of which has the form n.m, where n is a file 
number and m is a field number. 


— te Uses character ¢ as a separator (tab character). Every 
appearance of ¢ in a line is significant. 
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See Also 


awk(C), comm(C), sort({C) 


YY Notes 
With default field separation, the collating sequence is that of sort 
— b; with — t, the sequence is that of a plain sort. 
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Name 


kill - Terminates a process. 


Syntax 


kill [ — signo ] processid ... 


Description 


Kill sends signal 15 (terminate) to the specified processes. This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process started with & is 
reported by the shell (unless more than one process is started in a 
pipeline, in which case the number of the last process in the pipeline 
is reported). Process numbers can also be found by using pa(C). 


For example, if process number 0 is specified, all processes in the 
process group are signaled. 


The killed process must belong to the current user unless he is the 


super-user. 


signal is sent instead of the terminate signal (see eignal(S)). In par- 
ticular ‘‘kill- 9...’ is a sure kill. 


If a signal number preceded by — is given as the first argument, that a. 


See Also 


ps(C), sh(C), kill(S), signal(S) 
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i — Lists information about contents of directory. 


Syntax 


1 {[ — asdrucifgot ] name ... 


Description 


For each directory argument, / lists the contents of the directory; for 
each file argument, / repeats its name and other requested informa- 
tion. The output is sorted alphabetically by default. When no argu- 
ment is given, the current directory is listed. When several argu- 
ments are given, the arguments are first sorted appropriately, but file 
arguments appear before directories and their contents. Information 
is listed in the format of the ‘‘ls — |’ command, which is identical to 
the !command. This format and all provided switches are described 
in ls(C), to which should you should refer for a complete discussion 
of the capabilities of l. 


Files 
Jetc/passwd Contains user IDs 
/etc/group Contains group IDs 
Notes 


Newline and tab are considered printing characters in filenames. 


The output device is assumed to be 80 columns wide. 
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Name 


lc — Lists directory contents in columns. 


Syntax ry 
lc | — 1ACFRabcdfgilmnarstux | name ... a 
Description 


Le lists the contents of files and directories, in columns. If name is a 
directory name, lc lists the contents of the directory; if name is a 
filename, lc repeats the filename and any other information 
requested. Output is given in columns and sorted alphabetically. If 
no argument is given, the current directory is listed. If several argu- 
ments are given, they are sorted alphabetically, but file arguments 
appear before directories. 


Files that are not the contents of a directory being interpreted are 
always sorted across the page rather than down the page in columns. 
A stream output format is available in which files are listed across 
the page, separated by commas. The — m option enables this for- 
m at. 


The options are: 


— 1 Forces an output format with one entry per line. 


—A 
Displays all files, including ‘‘..’’ and those that begin with ‘‘.’’, 
unless the user is super-user. If the super-user gives this option, 
‘*.. and filenames that begin with ‘‘.’’ are not displayed. 


—-C 
Forces columnar output, even if redirected to a file. 


— F Causes directories to be marked with a trailing ‘‘/’’ and execut- 
able files to be marked with a trailing ‘‘*’’. 


—-R 


Recursively lists subdirectories. 


See ie 33 
e 


— a Lists all entries; usually and ‘‘..’’ are suppressed. 
— b Forces printing of nongraphic characters in the \ddd notation, in 


octal. 


—c Sorts by time of file creation. 


—dlIf the argument is a directory, lists only its name, not its con- 
tents (mostly used with — | to get status on directory). 
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f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off — Il, — t, — s, 
and — r, and turns on — a; the order is the order in which 
entries appear in the directory. 


g The same as — Il, except that the owner is not printed. 


i Prints inode number in first column of the report for each file 
liste d. 


1 Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file. 
If the file is a special file the size field instead contains the major 
and minor device numbers. 


o The same as — lI, except that the group is not printed. 


m 
Forces stream output format. 


n Same as the — 1 switch, but the owner’s user ID appears instead 
of the owner’s name. If used in conjunction with the — g 
switch, the owner’s group ID appears instead of the group 
name. 


q Forces printing of nongraphic characters in filenames as the 
character **T.**. 


r Reverses the order of sort to get reverse alphabetic or oldest 
first as appropriate. 


s Gives size in 512-byte blocks, including indirect blocks for each 
entry. 


t Sorts by time modified (latest first) instead of by name, as is 
normal. 


u Uses time of last access instead of last modification for sorting 
(— t) or printing (— 1). 


x Forces columnar printing to be sorted across rather than down 
the page. 


The mode printed under the — | option contains 11 characters. The 
first character is: 


d 


b 


If the entry is a plain file 
If the entry is a directory 


If the entry is a block-type special file 
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c If the entry is a character-type special file 
p If the entry is a named pipe 
s If the entry is a semaphore 


m If the entry is shared data (memory) 


The next 9 characters are interpreted as 3 sets of 3 bits each. The 
first set refers to owner permissions; the next to permissions to oth- 
ers in the same user-group; and the last to all others. Within each 
set the 3 characters indicate permission respectively to read, to write, 
or to execute the file as a program. For a directory, ‘‘execute’’ per- 
mission is interpreted to mean permission to search the directory for 
a specified file. The permissions are indicated as follows: 


r If the file is readable 

w If the file is writable 

x If the file is executable 

— If the indicated permission is not granted 

The group-execute permission character is given as s if the file has 


set-group-ID mode; likewise the user-execute permission character is “Aa 


given as s if the file has set-user-ID mode. 


The last character of the mode (normally ‘‘x’’ or ‘‘— ’’) is t if the 
1000 bit of the mode is on. See chmod(C) for the meaning of this 
mode. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is printed. 


Files 
/etc/passwd To get user IDs for ‘‘le — |’ 
/etc/group To get group IDs for ‘‘Ic — g”’ 


Credit 


and is used with permission. 


This utility was developed at the University of California at Berkeley ry 


Notes 


Newline and tab are considered printing characters in filenames. 
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The output device is assumed to be 80 columns wide. 


Column width choices are poor for terminals that can tab. 


June 8, 1984 


LO(C) 


Page 4 


LINE (C) LINE (C) 


Name 


line — Reads one line. 


Syntax 


line ty 


Description 


Line copies one line {up to a newline) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on 
end-of-file and always prints at least a newline. It is often used 
within shell files to read from the user’s terminal. 


See Also 


gets( CP), sh(C) 
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Name 


In — Makes a link to a file. 


Syntax 


In namel name2 


Description 
A link is a directory entry referring to a file; the same file (together 
with its size, all its protection information, etc.) may have several 
links to it. There is no way to distinguish a link to a file from its ori- 
ginal directory entry. Any changes to the file are effective indepen- 
dent of the name by which the file is known. 


[In creates a link to the existing file namel. The name2 argument is 
anew name referring to the same file contents as namel. 


It is forbidden to link to a directory or to link across file systems. 


See Also 


cp(C), mv(C), rm(C) 
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Name 


logname — Gets login name. 


Syntax 


logname ry 


Description 


Logname returns the contents of the environment variable $LOG- 
NAME, which is set when a user logs into the system. 


See Also 


env(C), login(M), logname(S), environ(M) 
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Name 


look — Finds lines in a sorted list. 


Syntax 


look [ — df] string [ file ] 


Description 


Look consults a sorted file and prints all lines that begin with string. 
It uses binary search. 


The options d and f affect comparisons as in sort(C): 


— d Dictionary order: only letters, digits, tabs and blanks participate 
in comparisons. 


—f Fold. Uppercase letters compare equal to lowercase. 


If no file is specified, /usrfdicthvords is assumed with collating 
sequence — df. 


YY Files 


/usr/dict/words 


See Also 


sort(C), grep(C) 


z L. ’ 
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Name 


Ipr — Sends files to the lineprinter queue for printing. 


Syntax ry 
Ipr[ option ... ] [ name ... ] 
Description 


Lpr causes the named files to be queued for printing on a lineprinter. 
If no names appear, the standard input is assumed; thus lpr may be 
used as a filter. 


The following options may be given (each as a separate argument 
and in any order) before any filename arguments: 


—c Makes a copy of the file and prints the copy and not the ori- 
ginal. Normally files are linked whenever possible. 


—r Removes the file after sending it. 
—m When printing is complete, reports that fact by mail(C). 


—n Does not report the completion of printing by matl(C). This 
is the default option. 


The file /etc/default/Ipd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 


Files 
/etc/passwd User’s identification and accounting data 
/usr/lib/Ipd Lineprinter daemon 
/usr/spool/Ipd/* Spool area 
/etc/default/Ipd Contains BANNERS default setting 
See Also 
banner(C) 
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Notes 


Once a file has been queued for printing, it should not be changed or 
deleted until printing is complete. If you want to alter the contents 
of the file or to remove the file immediately, use the — c option to 


we force lpr to make its own copy of the file. 
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Name 


ls — Gives information about contents of directories. 


Syntax 


Is [ — logtasdrucif ] names 


Description 


For each directory named, ls lists the contents of that directory; for 
each file named, /s repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several 
arguments are given, the arguments are first sorted appropriately, 
but file arguments are processed before directories and their con- 
tents. There are several options: 


— 1 Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file 
(see below). If the file is a special file, the size field will contain 
the major and minor device numbers, rather than a size. 


— o The same as — ], except that the group is not printed. 
— g The same as — l, except that the owner is not printed. tn 
—t Sorts by time of last modification (latest first) instead of by 

name. 


— a Lists all entries; in the absence of this option, entries whose 
names begin with a period (.) are not listed. 


— s Gives size in 512-byte blocks including indirect blocks for each 
entry. 


— dIf argument is a directory, lists only its name; often used with 
— ] to get the status of a directory. 


—r Reverses the order of sort to get reverse alphabetic or oldest 
first, as appropriate. 


— u Uses time of last access instead of last modification for sorting 


(with the — t option) and/or printing (with the — 1 option). ty 


—c Uses time of last modification of the inode (mode, etc.) instead 
of last modification of the file for sorting (— t) and/or printing 


ee 


— i For each file, prints the inode number in the first column of the 
report. 
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— f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off — 1, — t, — s, 
and — r, and turns on — a; the order is the order in which 
entries appear in the directory. 


The mode printed under the — 1 option consists of 11 characters. 
The first character is: 


— If the entry is an ordinary file 


d_ If the entry is a directory 

b_ If the entry is a block special file 

c If the entry is a character special file 

p If the entry is a named pipe 

s If the entry is a semaphore 

m If the entry is a shared data (memory) file 

The next 9 characters are interpreted as 3 sets of 3 bits each. The 
first set refers to the owner’s permissions; the next to permissions of 
others in the user-group of the file; and the last to all others. Within 
each set, the 3 characters indicate permission to read, to write, and 
to execute the file as a program, respectively. For a directory, ‘‘exe- 


cute’’ permission is interpreted to mean permission to search the 
directory for a specified file. 


The permissions are indicated as follows: 

r If the file is readable 

w_ If the file is writable 

x If the file is executable 

— If the indicated permission is not granted 


The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise, the user-execute permission character 
is given as s if the file has set-user-ID mode. The last character of 
the mode (normally x or — ) is t if the 1000 (octal) bit of the mode 
is on; see chmod(C) for the meaning of this mode. The indications 
Y of set ID and 1000 bit of the mode are capitalized if the correspond- 


ing execute permission is not set. 


When the sizes of the files in a directory are listed, a total count of 
blocks including indirect blocks is printed. 
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Files 
/etc/passwd Gets user IDs for Is —- ] and ls - o 
/etc/group Gets group IDs for ls — | and ls - g 


See Also oO 


chmod(C), find(C), I(C), Ic(C) 


Notes 


Newline and tab are considered printing characters in filenames. 
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Name 


mail — Sends, reads or disposes of mail. 


Syntax 
mail [{[—u user] [-f mailbox]] [-e] [-R] [—i] [ users ...] 


mail [—s subject] [—i] [ user ...] 


Description 


Mail is a mail processing system that supports composing of messages, 
and sending and receiving of mail between multiple users. When send- 
ing mail, a user is the name of a user or of an alias assigned to a 
machine or to a group of users. 


Options include: 


—u user 
Tells mail to read the system mailbox belonging to the specified 
user. 


—f matlboz 
Tells matl to read the specified maslboz instead of the default 
user’s system mailbox. 


—e Allows escapes from compose mode when input comes from a file. 


—R Makes the mail session ‘‘read-only” by preventing alteration of 
the mailbox being read. Useful when accessing system-wide mail- 
boxes. 


—1 Tells matl to ignore interrupts sent from the terminal. This is 
useful when reading or sending mail over telephone lines where 
‘noise’? may produce unwanted interrupts. 


—s subject 
Specifies subject as the text of the Subject: field for the message 
being sent. 


Sending mail 


-_ . 
Y To send a message to one or more other people, invoke mat! with 


arguments which are the names of people to send to. You are then 
expected to type in your message, followed by a CNTRL-D at the 
beginning of a line. 
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Reading Mail 


To read mail, invoke ma:l with no arguments. This will check your 
mail out of the system-wide directory so that you can read and dispose 
of the messages sent to you. A message header is printed out for each 
message in your mailbox The current message is initially the last num- 
bered message and can be printed using the print command (which 
can be abbreviated p). You can move among the messages much as 
you move between lines in ed, with the commands + and — moving 
backwards and forwards, and simple numbers typing the addressed 
message. 


If new mail arrives during the mail session you can read in the new 
messages with the restart command. 


Disposing of Mail 


After examining a message you can delete (d) the message or reply 
(r) to it. Deletion causes the masl program to forget about the mes- 
sage. This is not irreversible, the message can be undeleted (u) by 
giving its number, or the mail session can be aborted by giving the 
exit (x) command. Deleted messages will, however, usually disappear 
never to be seen again. 


Specifying Messages 


Commands such as print and delete often can be given a list of mes- 
sage numbers as argument to apply to a number of messages at once. 
Thus ‘‘delete 1 2’’ deletes messages 1 and 2, while ‘‘delete 1—5’’ deletes 
messages 1 through 5. The special name ‘‘*’’ addresses all messages, 
and ‘‘$’ addresses the last message; thus the command top which 
prints the first few lines of a message could be used in ‘‘top *”’ to print 
the first few lines of all messages. 


Replying to or Originating Mail 


You can use the reply command to set up a response to a message, 
sending it back to the person who it was from. Text you then type in, 
up to a CNTRL-D defines the contents of the message. While you are 
composing a message, matl treats lines beginning with a tilde (~) as 
special. For instance, typing ‘‘°m” (alone on a line) places a copy of 
the current message into the response, right shifting it by one tabstop. 
Other escapes set up subject fields, add and delete recipients to the 
message, and allow you to escape to an editor to revise the message or 
to a shell to run some commands. (These options are be given in the 
summary below.) 


June 8, 1984 Page 2 


MAIL (C) MAIL (C) 


Ending a Mal Seseton 


You can end a matl session with the quit (q) command. Messages 

which have been examined go to your mdoz file unless they have been 

deleted in which case they are discarded. Unexamined messages go 

back to the post office. The —f option causes masl to read in the con- 
& tents of your mboz (or the specified file) for processing; when you quit 

matl writes undeleted messages back to this file. The —i option causes 
matl to ignore interrupts. 


Using Aliases and Distribution Lists 


It is also possible to create a personal distribution lists so that, for 
instance, you can send mail to ‘‘cohorts’”’ and have it go to a group of 
people. Such lists can be defined by placing a line like 


alias cohorts bill bob barry bobo betty beth bobbi 


in the file .mailrc in your home directory. The current list of such 
aliases can be displayed by the alias (a) command in mail. System- 
wide distribution lists can be created by editing /usr/lib/mail/aliases, 
see altases(M); these are kept in a slightly different syntax. In mail 
you send, personal aliases will be expanded in mail sent to others so 
that they will be able to reply to the recipients. System-wide altases 
are not expanded when the mail is sent, but any reply returned to the 
machine will have the system-wide alias expanded. 


Mail has a number of options which can be set in the .mailre file to 
alter its behavior; thus ‘‘set askcc’’ enables the ‘‘askcc’’ feature. 
(These options are summarized below.) 
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Summary 


MAIL (C) 


Each mail command is typed on a line by itself, and may take argu- 
ments following the command word. The command need not be typed 
in its entirety — the first command which matches the typed prefix is 
used. For the commands that take message lists as arguments, if no 
message list is given, then the next message forward that satisfies the 
command’s requirements is used. If there are no messages forward of 
the current message, the search proceeds backwards, and if there are 
no good messages at all, matl types ‘‘No applicable messages’’ and 
aborts the command. 


RETURN 


alias 


cd 


delete 


dp 


echo path 
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Goes to the previous message and prints it out. If given 
a numeric argument n, goes to the nth previous message 
and prints it. 


Goes to the next message and prints it out. If given a 
numeric argument n, goes to the nth next message and 
prints it. 

Goes to the next message and prints it out. 

Prints a brief summary of commands. 

Executes the shell command which follows. 

Prints out the current message number. 

Prints out the first message. 

Prints out the last message. 

(a) With no arguments, prints out all currently-defined 
aliases. With one argument, prints out that alias. With 
more than one argument, adds the users named in the 
second and later arguments to the alias named in the 
first argument. 

(c) Changes the user’s working directory to that 
specified, if given. If no directory is given, then changes 
to the user’s login directory. 

(d) Takes a list of messages as an argument and marks 
them all as deleted. Deleted messages are not retained in 
the system mailbox after a quit, nor are they available to 


any command other than the undelete command. 


Deletes the current message and prints the next message. 
If there is no next message, mail says ‘‘at EOF.” 


Expands shell metacharacters. 
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edit 


exit 


file 


forward 


Forward 


headers 


hold 


list 


Ipr 


mail 


mbox 
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(e) Takes a list of messages and points the text editor at 
each one in turn. On return from the editor, the message 
is read back in. 


(x) Effects an immediate return to the shell without 
modifying the user’s system mailbox, his mboz file, or his 
edit file in —f . 


(fi) Switches mailbox files to the file given by a filename 
argument. (Not yet implemented.) 


(f) Forwards the current message to the named users. 
Current message is indented within forwarded message. 


(F) Forwards the current message to the named users. 
Current message is not indented within forwarded mes- 
sage. 


(h) Lists the current range of headers, which is an 18 
message group. If a ‘‘+’’ argument is given, then the 
next 18 message group is printed, and if a ‘‘—’”’ argument 
is given, the previous 18 message group is printed. Both 
“+>? and ‘-”? may take a number to view a particular 
window. If a message-list is given, it prints the specified 
headers. 


(ho) Takes a message list and marks each message 
therein to be saved in the user’s system mailbox instead 
of in mboz. Use only when the switch automboz is set. 
Does not override the delete command. 


Prints list of mail commands. 


(1) Prints out each message in a message-list on the line- 
printer. 


(m) Takes as argument login names and distribution 
group names and sends mail to those people. 


(mb) Marks messages in a message list so that they are 
saved in the user mailbox after leaving mail. 


move mesg-list mesg-num 


next 


print 
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Places the messages specified in mesg-list after the mes- 
sage specified in mesg-num. If mesg-num is 0, meag-list 
moves to the top of the mailbox. 


(n like + or RETURN) Goes to the next message in 
sequence and prints it. With an argument list, types the 


next matching message. 


(p) Prints out each message in a message-list on the ter- 
minal display. 
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quit 


reply 


Reply 


restart 


save 


set 


shell 


size 


source 


MAIL (C) 


(q) Terminates the session, retaining all undeleted, 
unsaved messages in the system mailbox and removing 
all other messages. Files marked with a star (*) are 
saved; files marked with an ‘‘M” are saved in the user 
mailbox. If new mail has arrived during the session, the 
message ‘““You have new mail’’ is given. If given while 
editing a mailbox file with the —f flag, then the edit file is 
rewritten. The user returns to the shell, unless the 
rewrite of edit file fails, in which case the user can escape 
with the exit command. 


(r) Takes a message list and sends mail to each message 
author. The default message must not be deleted. 


(R) Takes a message list and sends mail to each message 
author and each member of the message just like the 
mail command. The default message must not be 


deleted. 


Reads in messages that arrived during the current mail 
session. 


(s) Takes a message list and a filename and appends each 
message in turn to the end of the file. The filename, in 
quotation marks, followed by the line count and charac- 
ter count is echoed on the user’s terminal. 


(se) With no arguments, prints all variable values. Oth- 
erwise, sets option. Arguments are of the form 
“option=value”’ or ‘“‘option”’. 


(sh) Invokes an interactive version of the shell. 


(si) Takes a message list and prints out the size in char- 
acters of each message. 


(so) Reads mail commands from the file given as its only 
argument. 


string string mesg-ltst 


top 


undelete 


unset 
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Searches for string in mesg-list. If no meag-list is 
specified, all undeleted messages are searched. Case is 
ignored in search. 


(t) Takes a message list and prints the top few lines of 
each. The number of lines printed is controlled by the 
variable toplines and defaults to five. 


(u) Takes a message list and marks each one as not being 


deleted. 


(uns) Takes a list of option names and discards their 
remembered values; the inverse of set . 
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visual (v) Takes a message list and invokes vi on each message. 


write filename 
(w) Saves the body of the message in the named file. 


Here is a summary of the compose escapes, which are used when com- 
posing messages to perform special functions. Compose escapes are 
only recognized at the beginning of lines. 


~~ string Inserts the string of text in the message prefaced by a 
single tilde ("). If you have changed the escape character, 
then you should double that character instead. 


> Prints out help for compose escapes. 
Same as CNTRL-D on a new line. 


“lemd Executes the indicated shell command, then returns to 
the message. 


“lemd Pipes the message through the command as a filter. If 
the command gives no output or terminates abnormally, 
retains the original text of the message. 


~_ matl-command 
Executes a mail command, then returns to compose 
mode. 


~: matl-command 
Executes a mail command, then returns to compose 
mode. 


“alias Prints list of private aliases 


“alias alrasname 
Prints names included in private altasname. 


~Alias Prints list of private, then system-wide aliases for all 
users named in the current To, Cc and Bcc lists. 


“Alias users 
Prinst list of private, then system-wide aliases for users. 


“b name... Adds the given names to the list of blind carbon copy 


recipients. 
vy “c name... Adds the given names to the list of carbon copy reci- 
pients. 
“cc name... Same as c above. 
“d Reads the file dead.letter from your home directory into 


the message. 
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“m mesg-lrst 


“M mesg-list 


“r filename 
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Invokes the text editor on the message collected so far. 
After the editing session is finished, you may continue 
appending text to the message. 


Edits the message header fields by typing each one in 
turn and allowing the user to append text to the end or 
modify the field with the current terminal erase and kill 
characters. 


Reads the named messages into the message buffer, 
shifted right one tab. If no messages are specified, reads 
the current message. 


Reads the named messages into the message buffer, 
shifted right one tab. If no messages are specified, reads 
the current message. 


Prints out the messages collected so far, prefaced by the 
message header fields. 


Aborts the message being sent, copying the message to 
dead.letter in your home directory if save is set. 


Reads the named file into the message buffer. 


“Return name 


“s string 


“t name... 


“w filename 


Adds the given names to the Return-receipt-to field. 


Causes the named string to become the current subject 


field. 

Adds the given names to the direct recipient list. 

Invokes a visual editor (defined by the VISUAL option) 
on the message buffer. After you quit the editor, you 


may resume appending text to the end of your message. 


Writes the body of the message to the named file. 


Options are controlled with the set and unset commands. An option 
may be either a switch, in which case it is either on or off, or a string, 
in which case the actual value is of interest. The switch options 
include the following: 


askcc 


asksubject 
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Causes you to be prompted for additional carbon 
copy recipients at the end of each message. Respond- 
ing with a newline indicates your satisfaction with 
the current list. 


Causes matl to prompt you for the subject of each 
message you send. If you respond with simply a 
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autombox 


autoprint 


chron 


dot 


ignore 


mchron 


metoo 


nosave 


prepend 


quiet 
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newline, no subject field is sent. 


Causes all examined messages to be saved in the user 
mailbox unless deleted or saved. 


Causes the delete command to behave like dp — 
thus, after deleting a message, the next one will be 
typed automatically. 


Causes messages to be displayed in chronological 
order. 


Permits use of dot (.) as the end of file character 
when composing messages. 


Causes interrupt signals from your terminal to be 
ignored and echoed as at-signs (@). 


Causes messages to be listed in numerical order (most 
recently received first), but displayed in chronological 
order. 


Usually, when a group is expanded that contains the 
sender, the sender is removed from the expansion. 
Setting this option causes the sender to be included in 
the group. 


Prevents aborted messages from being appended to 
the file dead.letter in your home directory on receipt 
of two interrupts (or a ~q.) 


Causes messages saved in mboz to be prepended to 
the end rather than appended. 


Suppresses the printing of the version header when 
first invoked. 


The following options have string values: 


EDITOR 


SHELL 


VISUAL 


escape 
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Pathname of the text editor to use in the edit com- 
mand and ‘e escape. If not defined, then a default 
editor is used. 


Pathname of the shell to use in the ! command and 
the “! escape. A default shell is used if this option is 
not defined. 


Pathname of the text editor to use in the visual 
command and_ v escape. 


If defined, the first character of this option gives the 


character to use in the place of the tilde (~) to denote 
escapes. 
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page—n Specifies the number of lines (n) to be printed in a 
‘“‘nage’’ of text when displaying messages. 
record If defined, gives the pathname of the file used to 
record all outgoing mail. If not defined, then outgo- 
ing mail is not saved. 
toplines If defined, gives the number of lines of a message to 
be printed out with the top command; normally, the 
first five lines are printed. 
Files 
/usr/spool/mail/* System mailboxes 


/usr/name/dead. letter 
/usr/name/mbox 
/usr/name/.mailre 
/usr/lib/mail/aliases 
/usr/lib/mail/aliases. hash 
/usr/lib/mail/faliases 
/usr /lib/mail/maliases 
/usr /lib/mailhelp.cmd 
/usr /lib/mailhelp.esc 
/usr/lib/mailhelp.set 
/usr/lib/mail/mailre 


/bin/mail 


June 8, 1984 


File where undeliverable mail is deposited. 
Your old mail 

File giving initial mail commands 
System-wide aliases 

System-wide alias database 


Forwarding aliases for the local machine % 


Machine aliases 

Help file 

Help file 

Help file 

System initialization file 


The mail command 
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See Also 


aliases(M), aliashash(M), netutil(C) 


& Credit 
This utility was developed at the University of California at Berkeley 


and is used with permission. 
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Name 


mesg — Permits or denies messages sent to a terminal. 


Syntax 


mesg[n] [y] o 


Description 


Mesg with argument n forbids messages via wnte(C) by revoking 
nonuser write permission on the user’s terminal. Mesg with argu- 
ment y reinstates permission. All by itself, mesg reports the current 
state without changing it. 


Files 


/dev /tty* 


See Also 


write(C) “A 


Diagnostics 


Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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Name 


mkdir — Makes a directory. 


Syntax 


mkdir dirname ... 


Description 


Mkdir creates directories. The standard entries ‘‘dot’’ (.), for the 
directory itself, and ‘‘dot dot’’ (..), for its parent, are made automat 
ically. 


Mkdir requires write permission in the parent directory. The permis- 
sions assigned to the new directory are modified by the current file 
creation mask set by umask (C). 


See Also 


rmdir(C), umask(C) 


VY Diagnostics 


Mkdir returns exit code 0 if all directories were successfully made; 
otherwise, it prints a diagnostic and returns nonzero. 


© 
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Name 


mkfs — Constructs a file system. 


Syntax 


/etc/mkfs [ — y] [ — n] special blocks[ : inodes] [gap blocks] 
/etc/mkfs | — y] [ — n] special proto [gap blocks] 


Description 


Mkfs constructs a file system by writing on the special file according 
to the directions found in the remainder of the command line. 


If it appears that the special file contains a file system, operator con- 
firmation is requested before overwriting the data. The — y ‘‘yes”’ 
option overrides this, and writes over any existing data without ques- 
tion. The -n option causes mkfs to terminate without question if the 
target contains an existing file system. The check used is to read 
block one from the target device (block one is the super block) and 
see whether the bytes are the same. If they are not, this is taken to 
be meaningful data and confirmation is requested. 


If the second argument is given as a string of digits, mkfe builds a 
file system with a single empty directory on it. The size of the file 
system is the value of blocks interpreted as a decimal number. The 
boot program is left uninitialized. If the number of inodes is speci- 
fied, then this number should be the same as the estimated number 
of files in the file system. If the optional number of inodes is not 
given, the number of inodes is calculated as a function of the system 
file size. 


If the second argument is a file name that can be opened, mkfs 
assumes it to be a prototype file proto, and will take its directions 
from that file. The prototype file contains tokens separated by 
spaces or new-lines. The first token is the name of a file to be 
copied onto block zero as the bootstrap program. The bootstrap pro- 
gram specified should already be stripped of the header (see 
strip(CP)). If the header has not be stripped from the bootstrap pro- 
gram, then mkfs will issue a warning. The second token is a number 
specifying the size of the created file system. Typically it will be the 
number of blocks on the device, perhaps diminished by space for 
swapping. The next token is the 1-list size in blocks. The next set of 
tokens comprise the specification for the root file. File specifications 
consist of tokens giving the mode, the user ID, the group ID, and 
the initial contents of the file. The syntax of the contents field 
depends on the mode. 


The mode token for a file is a 6 character string. The first character 
specifies the type of the file. (The characters -bcd specify regular, 
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block special, character special and directory files respectively.) The 
second character of the type is either u or - to specify set-user-id 
mode or not. The third is gor - for the set-group-id mode. The rest 
of the mode is a three digit octal number giving the owner, group, 
and other read, write, execute permissions (see chmod(C)). 


& Two decimal number tokens come after the mode; they specify the 


user and group ID’s of the owner of the file. 


If the file is a regular file, the next token is a pathname whence the 
contents and size are copied. If the file is a block or character spe- 
cial file, two decimal number tokens follow which give the major and 
minor device numbers. If the file is a directory, mkfs makes the 
entries . and .. and then reads a list of names and (recursively) file 
specifications for the entries in the directory. The scan is terminated 
with the token $. 


A sample prototype specification follows: 


/stand/diskboot 

4872 110 

d--777 3 1 

usr d--777 3 1 
sh ---755 3 1 /bin/sh 
ken d--755 6 1 

$ 

bO b--644310 
cO c--644310 
$ 


0 
0 


$ 


In both command syntaxes, the disk interleaving factors, gap and 
blocks , can be specified. The interleaving factors are a function of 
the disk hardware and are described in detail in the XENIX Operations 
Guide. 


See Also 


filesystem(F), dir(F) 


Notes 


There is no way to specify links when using a prototype file. If the 
© number of inodes is specified on the command line, then the max- 


imum number of inodes in the file system is 65500. 
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Name 


mknod-— Builds special files. 


Syntax 4) 
/etc/mknod name [ c] [ b] major minor 


/etc/mknod name p 


/etc/mknod name s 


/etc/mknod name m 


Description 


Mknod makes a directory entry and corresponding inode for a special 
file. The first argument is the name of the entry. In the first case, 
the second argument is bif the special file is block-type (disks, tape) 
or c if it is character-type (other devices). The last two arguments 
are numbers specifying the major device type and the minor device 
(e.g. unit, drive, or line number), which may be either decimal or 
octal. 


The assignment of major device numbers is specific to each system. “a 
Mknod can also be used to create named pipes with the p option; 
semaphores with the s option; and shared data(memory) with the m 


option. 


Only the super-user can use the first form of the syntax. 


See Also 


mknod(S) 
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Name 


mkuser — Adds a login ID to the system. 


Syntax 


/etc/mkuser 


Description 


Mkuser is used to add more user login IDs to the system. It is the 
preferred method for adding new users to the system, since it han- 
dles all directory creation and password file update. To add a new 
user to the system, mkuser requires four pieces of information: the 
login name, the initial password, the group identification, and an 
optional comment string for the password file. It also allows the new 
user to be assigned to a group if required, although in most cases a 
default group is suitable. The program prompts for these four items 
and validates the given data. The login name is checked against cer- 
tain criteria (i.e., it must be at least three characters and begin with a 
lowercase letter). The password must follow standard XENIX con- 
ventions, see passwd(C). The password file comment field can be up 
to 20 characters of information. 


Mkuser takes some of its parameters from a default file, 
jetc/default/mkuser. Currently, one may set the root path of home 
directories. An example default file is: 


HOME=/usr 


This file can be edited (by the super-user) to change this default. 
There are three other files in the directory fusrftb which may also be 
altered to suit local options. They are mkuser.help which is the intro- 
ductory explanation given by mkuseron startup, mkuser.matl which is 
the initial mail message sent to new users, and mkueser.prof, the stan- 
dard .profile file given to new users. 


Mkueer allocates user IDs starting at 200, or the largest number used 
in the password file. The default group ID for new users is 50. The 
minimum group ID allowed for user accounts is 50. The program 
prompts the operator for an optional group specification. This can 
either be a numeric group ID, or a group name. If the group exists 
the user is added to it. If it does not exist a new entry in /etc/group is 
created. A new group cannot have a numeric ID less than 51. If a 

& new group is to be created, and the operator only specifies the group 
name, a free group ID is assigned. Alternatively the operator can 
specify the group ID too. 


Mkuser can only be executed by the super-user. 
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The minimum length of a legal password, and the minimum and 
maximum number of weeks used in password aging are specified in 
/etc/default/passwd by the variables PASSLENGTH, MINWEEKS and 
MAXWEEKS. For example, these variables might be set as follows: 


PASSLENGTH =6 
MINWEEKS~=2 
MA XWEEKS=6 of 
Files 
/etc/passwd 


/usr/spool/mail/ username 
/etc/default/mkuser 
/usr/lib/mkuser.help 
/usr/lib/mkuser.prof 


/usr/lib/mkuser.mail 


See Also a 
rmuser(C), passwd(C), pwadmin(C) 
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Name 


more — Views a file one screen full at a time. 


Syntax 


more [ — cdflsur] [ — n] [ +linenumber] [ +/pattern] [ name... ] 


Description 


This filter allows examination of a continuous text one screen full at 
a time. It normally pauses after each screen full, printing ‘‘--More-- 
** at the bottom of the screen. If the user then types a carriage 
return, one more line is displayed. If the user hits the SPACE bar, 
another screen full is displayed. Other possibilities are described 
below. 


The command line options are: 


— n An integer which is the size (in lines) of the window which more 
will use instead of the default. 


—c More draws each page by beginning at the top of the screen and 
erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to 
clear to the end of a line. 


— d More prompts with the message ‘‘Hit space to continue, Rubout 
to abort” at the end of each screen full. This is useful if more is 
being used as a filter in some setting, such as a class, where 
many users may be unsophisticated. 


—f This option causes more to count logical, rather than screen 
lines. That is, long lines are not folded. This option is recom- 
mended if nroff output is being piped through ul, since the latter 
may generate escape sequences. These escape sequences con- 
tain characters that would ordinarily occupy screen positions, but 
that do not print when they are sent to the terminal as part of 
an escape sequence. Thus more may think that lines are longer 
than they actually are and fold lines erroneously. 


— 1 Does not treat CNTRL-L (form feed) specially. If this option is 
not given, more pauses after any line that contains a CNTRL-L, 
as if the end of a screen full had been reached. Also, if a file 
begins with a form feed, the screen is cleared before the file is 
printed. 


— s Squeezes multiple blank lines from the output, producing only 


one blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 
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—u Normally, more handles underlining, such as that produced by 
nroff in a manner appropriate to the particular terminal: if the 
terminal can perform underlining or has a stand-out mode, more 
outputs appropriate escape sequences to enable underlining or 
stand-out mode for underlined information in the source file. 
The — u option suppresses this processing. 


—r Normally, more ignores control characters that it does not inter- 
pret in some way. The — r option causes these to be displayed 
as “C where ‘‘C’’ stands for any such character. 


— Ww 
Normally, more exits when it comes to the end of its input. With 
—~ w however, more prompts and waits for any key to be struck 
before exiting. 


+linenumber 
Starts up at linenumber. 


+ /pattern 
Starts up two lines before the line containing the regular expres- 
sion pattern. 


More looks in the file fetefermcap to determine terminal characteris- 
tics, and to determine the default window size. On a terminal capa- 
ble of displaying 24 lines, the default window size is 22 lines. 


More looks in the environment variable MORE to preset any flags 
desired. For example, if you prefer to view files using the — c mode 
of operation, the shell command ‘‘MORE=- c’’ in the .profile file 
causes all invocations of more to use this mode. 


If more is reading from a file, rather than a pipe, then a percentage is 
displayed along with the ‘‘--More--’’ prompt. This gives the fraction 
of the file (in characters, not lines) that has been read so far. 


Other sequences which may be typed when more pauses, and their 
effects, are as follows (1 is an optional integer argument, defaulting 
to 1): 


t<space > 
Displays + more lines, (or another screen full if no argument is 
given). 


CNTRL-D 
Displays 11 more lines (a ‘‘scroll’’). If tis given, then the scroll 
size is set to +. 


d Same as CNTRL-D. 


tz Same as typing a space except that t, if present, becomes the 
new window size. 
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ts Skips? lines and prints a screen full of lines. 


tf Skips screen fulls and prints a screen full of lines. 


qorQ 


&Y Exits from more. 
= Displays the current line number. 


v Starts up the screen editor wt at the current line. (Note that wm 
may not be available with your system.) 


hor? 
Help command; Gives a description of all the more commands. 


1 /expr 

Searches for the t:th occurrence of the regular expression ezpr. 
If there are less than t occurrences of ezpr, and the input is a 
file (rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a screen full is displayed, starting two 
lines before the place where the expression was found. The 
user’s erase and kill characters may be used to edit the regular 
expression. Erasing back past the first column cancels the 
search command. 


tn Searches for the :th occurrence of the last regular expression 
entered. 

(Single quotation mark) Goes to the point from which the last 

search started. If no search has been performed in the current 

file, this command goes back to the beginning of the file. 


!command 
Invokes a shell with command. The characters % and ! in ‘‘com- 
mand” are replaced with the current filename and the previous 
shell command respectively. If there is no current filename, % 
is not expanded. The sequences ‘‘\%’ and ‘‘\!’’ are replaced by 


oo ‘*!” respectively. 


i 


oO’ and 


tin Skips to the tth next file given in the command line (skips to 
last file if n doesn’t make sense). 


Skips to the :th previous file given in the command line. If this 
command is given in the middle of printing out a file, more goes 
back to the beginning of the file. If : doesn’t make sense, more 


YY skips back to the first file. If more is not reading from a file, the 


PY: 


bell rings and nothing else happens. 


:f Displays the current filename and line number. 


“4G ors) 
Exits from more (same as q or Q). 
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Repeats the previous command. 


The commands take effect immediately, i.e., it is not necessary to 
type a carriage return. Up to the time when the command character 
itself is given, the user may hit the line kill character to cancel the 
numerical argument being formed. In addition, the user may hit the 
erase character to redisplay the ‘‘--More--( 22%)’ message. 


The terminal is set to noecho mode by this program so that the out- 
put can be continuous. What you type will thus not show on your 
terminal, except for the slash (/) and exclamation (!) commands. 


If the standard output is not a teletype, more acts just like cat, except 
that a header is printed before each file (if there is more than one). 


A sample usage of more in previewing nroff output would be 


nroff — ms + 2 doc.n |more -s 


Files 
/etc/termcap Terminal data base 


/usr/lib/more.help Help file 


See Also “Aa 


csh(CP), sh(C), environ(M) 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 
The wt and help options may not be available. 


Before displaying a file, more attempts to detect whether it is a non- 
printable binary file such as a directory or executable binary image. If 
more concludes that a file is unprintable, it rightly refuses to print it. 


However, more cannot detect all possible kinds of non-printable files. ny 
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Name 


mount— Mounts a file structure. 


Syntax 
/etc/mount [ special-device directory [ — r]] 


/etc/umount special- device 


Description 


Mount announces to the system that a removable file structure is 
present on epectal-device. The file structure is mounted on directory. 
The directory must already exist; it becomes the name of the root of 
the newly mounted file structure. 


The mount and umount commands maintain a table of mounted dev- 
ices. If invoked with no arguments, for each special device mount 
prints the name of the device, the directory name of the mounted 
file structure, whether the file structure is readonly, and the date it 
was mounted. 


read-only. Physically write-protected must be mounted in this way 
or errors occur when access times are updated, whether or not any 
explicit write is attempted. 


& The optional last argument indicates that the file is to be mounted 


Umount removes the removable file structure previously mounted on 
device spectal-device. 


Files 


/etc/mnttab Mount table 


See Also 


umount(C), mount(S), mnttab(F) 


Diagnostics 
a 
& Mount issues a warning if the file structure to be mounted is 
currently mounted under another name. 


Busy file structures cannot be dismounted with umount. A file struc- 
ture is busy if it contains an open file or some user’s working direc- 


tory. 
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Notes 


Some degree of validation is done on the file structure, however it is 
generally unwise to mount corrupt file structures. 


in /etc/mnttab for default arguments (for example df, ncheck, quot, 
mount, and umount) give either incorrect results (due to a corrupt 
/etc/mnttab from a non-shutdown stoppage) or no results (due to 
an empty mnttab from a shutdown stoppage). 


Be warned that when in single-user mode, the commands that look ry 


When multi-user this is not a problem; /etcfr initializes /etc/mnttab 
to contain only /dev/root and subsequent mounts update it appropri- 
ately. 


The mount(C) and umount(C) commands use a lock file to guarantee 
exclusive access to /etc/mnttab, the commands which just read it 
(those mentioned above) do not, so it is possible to they may hit a 
window during which it is corrupt. This is not a problem in practice 
since mount and umount are not frequent operations. 
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Name 


mv — Moves or renames files and directories. 


Syntax 
mv filel file2 


mv file ... directory 


Description 
Mv moves (changes the name of) file! to file2. 
If file? already exists, it is removed before file! is moved. If file? 
has a mode which forbids writing, mv prints the mode (see 
chmod(S)) and reads the standard input to obtain a line; if the line 


begins with y, the move takes place; if not, mv exits. 


In the second form, one or more files are moved to the directory with 
their original filenames. 


Mv refuses to move a file onto itself. 


See Also 


cp(C), chmod(S), copy(C) 


Notes 


If filet and file? lie on different file systems, mv must copy the file 
and delete the original. In this case the owner name becomes that of 
the copying process and any linking relationship with other files is 
lost. 
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Name 


ncheck — Generates names from inode numbers. 


Syntax ‘y 
ncheck [ — inumbers] [-—a][-s] [ file-system ] 


Description 


Neheck with no argument generates a pathname vs. inode number 
list of all files on the set of file systems specified in /etc/mnttab. 
The two characters ‘‘/.’’ are appended to the names of directory 
files. The — i option reduces the report to only those files whose 
inode numbers follow. The — a option allows printing of the names 
. and .., which are ordinarily suppressed. The — 8s option reduces 
the report to special files and files with set-user-ID mode; it is 
intended to discover concealed violations of security policy. A single 
filesystem may be specified rather than the default list of mounted file 
systems. 


Files 


/etc/mnttab ry 


See Also 


fsck(C), sort({C) 


Diagnostics 


¢ 


When the file system structure is improper, ?? denotes the ‘‘parent’’ 
of a parentless file and a pathname beginning with ... denotes a loop. 


Notes 


See Notes under mount(C). 
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Name 


netutil _ Administers the XENIX network. 


Syntax 


netutil [ — option | 


Description 


The netutil command allows the user to create and maintain a net 
work of XENIX machines. A Micnet network is a link through serial 
lines of two or more XENIX systems. It is used to send mail between 
systems with the mail(C) command, transfer files between systems 
with the rep(C) command, and execute commands from a remote 
system with the remote(C) command. 


The netutil command is used to create and distribute the data files 
needed to implement the network. It is also used to start and stop 
the network. The option argument may be any one of install, save, 
restore, start, stop, or the numbers 1 through 5 respectively. 


The install option interactively creates the data files needed to run 

the network. The save option saves these files on floppy disks, allow- 
& ing them to be distributed to the other systems in the network. The 

restore option copies the data files from floppy disk back to a system. 
The start option starts the network. The stop option stops the net- 
work. An option may also be any decimal digit in the range 1 to 5. 
If invoked without an option, the command displays a menu from 
which to choose one. Once an option is selected, it prompts for addi- 
tional information if needed. 


A network must be installed before it can be started. Installation 
consists of creating appropriate configuration files with the install 
option. This option requires the name of each machine in the net 
work, the serial lines to be used to connect the machines, the speed 
of transmission for each line, and the names of the users on each 
machine. Once created, the files must be distributed to each com- 
puter in the network with the save and restore options. The network 
is started by using the start option on each machine in the network. 
Once started, mail and remote commands can be passed along the 
network. A record of the transmissons between computers in a net- 
work can be kept in the network log files. Installation of the net 


\& work is described in the XENIX Operations Gurde. 


Files 


/bin/netutil 
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See Also 


aliases(M), aliashash(M), mail(C), micnet(M), remote(C), rcp(C), 
systemid(M), top(M) XENIX Operations Guide 
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Name 


newgrp — Logs user in to a new group. 


Syntax 


newgrp [ group | 


Description 


Newgrp changes the group identification of its caller. The same per- 
son remains logged in, and the current directory is unchanged, but 
calculations of access permissions to files are performed with respect 
to the new group ID. 


Newgrp without an argument changes the group identification to the 
group in the password file; in effect it changes the group 


identification back to the caller’s original group. 


When most users log in, they are members of the group named 
other. 


Y Files 
/etc/group 


/etc/passwd 


See Also 


login(M), group(M) 
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Name 


nice - Runs a command at a different priority. 


Syntax 


nice [ — increment ] command [ arguments ] 


Description 


Nice executes command with a lower CPU scheduling priority. Priori- 
ties range from 0 to 39, where 0 is the highest priority and 39 is the 
lowest. Be default commands have a priority of 20. If an — incre- 
ment argument is given where tncrement is in the range 1-19, tncre- 
ment is added to the default priority of 20 to produce a numerically 
higher priority, meaning a lower scheduling priority. If no tncrement 
is given, an increment of 10 to produce a priority of 30 is assumed. 


The super-user may run commands with priority higher than normal 
by using a double negative increment. For example, an argument of 


--10 would decrement the default to produce a priority of 10, which 
is a higher scheduling priority than the default of 20. 


See Also “a 


nohup(C), nice(S) 


Diagnostics 


Nice returns the exit status of the subject command. 


Notes 


An increment larger than 19 is equivalent to 19. 
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Name 


nl— Adds line numbers to a file. 


Syntax 


nl [— htype] [— btype] [— ftype] [— vstart#] [— iincr] [— p] [- Inum] 
[— ssep] [— wwidth] [— nformat] file 


Description 


Nl reads lines from the named file, or the standard input if no file is 
named, and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 


effect. 


NI views the text it reads in terms of logical pages. Line numbering 
is reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. 
Different line numbering options are independently available for 
header, body, and footer (e.g. no numbering of header and footer 
lines while numbering blank lines only in the body). 


The start of logical page sections is signaled by input lines containing 
nothing but the following character(s): 


Page Section Line Contents 


Header Vik 
Body Le 
Footer \: 


Unless signaled otherwise, nl assumes the text being read is in a sin- 


gle logical page body. 


Command options may appear in any order and may be intermingled 
with an optional filename. Only one file may be named. The 
options are: 


— btype Specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a, 
number all lines; t, number lines with printable text only; 
& n, no line numbering; pstring, number only lines that 
contain the regular expression specified in stnng. Default 
type for logical page body is t (text lines numbered). 


— htype Same as — btype except for header. Default type for logi- 
cal page header is n (no lines numbered). 
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— ftype Same as — btype except for footer. Default for logical 
page footer is n (no lines numbered). 


—p Does not restart numbering at logical page delimiters. 


— vstart# Start# is the initial value used to number logical page 
lines. Default is 1. 


— itner Incr is the increment value used to number logical page 
lines. Default is 1. 


— ssep Sep is the character(s) used in separating the line number 
and the corresponding text line. Default sep is a tab. 


— wuidth Werdth is the number of characters to be used for the line 
number. Default wrdth is 6. 


— nformat Format is the line numbering format. Recognized values 
are: In, left justified, leading zeroes supressed; rn, right 
justified, leading zeroes supressed; rz, right justified, lead- 
ing zeroes kept. Default format is rn (right justified). 


— Inum Num is the number of blank lines to be considered as 
one. For example, — 12 results in only the second adja- 
cent blank being numbered (if the appropriate — ha, 


— ba, and/or — fa option is set). Default is 1. “ 


See Also 


pr(C) 
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Name 


nohup — Runs a command immune to hangups and quits. 


Syntax 


nohup command [ arguments |] 


Description 
Nohup executes command with hangups and quits ignored. If output 
is not redirected by the user, it will be sent to nohup.out. If 


nohup.out is not writable in the current directory, output is 
redirected to $HOME/nohup.out. 


See Also 


nice(C), signal(S) 
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Name 


od-— Displays files in octal format. 


Syntax Y 
od [— bedox] [ file ] [ [ + Joffset{ .][ b] ] 2 


Description 


Od displays file in one or more formats as selected by the first argu- 
ment. If the first argument is missing, — ois default. The meanings 
of the format options are: 


—b Interprets bytes in octal. 

—c Interprets bytes in ASCII. Certain nongraphic characters 
appear as C escapes: null=\0, backspace=\b, form feed=Yf, 
newline=\n, return=\r, tab=\t; others appear as 3-digit octal 


numbers. 


—d_ Interprets words in decimal. 


—o _ Interprets words in octal. 

— x Interprets words in hex. a 
The file argument specifies which file is to be displayed. If no file 
argument is specified, the standard input is used. 


The offset argument specifies the offset in the file where displaying is 
to start. This argument is normally interpreted as octal bytes. If . is 
appended, the offset is interpreted in decimal. If bis appended, the 
offset is interpreted in blocks of 512 bytes. If the file argument is 
omitted, the offset argument must be preceded by +. 


The display continues until end-of-file. 


See Also 


hd(C), adb( CP) 
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Name 


pack, pcat, unpack - Compresses and expands files. 


Syntax 
pack [— ] name... 


peat name... 


unpack name... 


Description 


Pack attempts to store the specified files in a compressed form. 
Wherever possible (and useful), each input file name is replaced by a 
packed file name.z with the same access modes, access and modified 
dates, and owner as those of name. If pack is successful, name will 
be removed. Packed files can be restored to their original form 
using unpack or peat. 


Pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the — argument is used, an internal flag is set that causes 
the number of times each byte is used, its relative frequency, and 
the code for the byte to be printed on the standard output. Addi- 
tional occurrences of — in place of name will cause the internal flag 
to be set and reset. 


The amount of compression obtained depends on the size of the 
input file and the character frequency distribution. Because a decod- 
ing tree forms the first part of each .z file, it is usually not 
worthwhile to pack files smaller than three blocks, unless the charac- 
ter frequency distribution is very skewed, which may occur with 
printer plots or pictures. 


Typically, text files are reduced to 60-75% of their original size. 
Load modules, which use a larger character set and have a more uni- 
form distribution of characters, show little compression, the packed 
versions being about 90% of the original size. 


Pack returns a value that is the number of files that it failed to 
compress. 


No packing will occur if: 
— The file appears to be already packed 


_ The filename has more than 12 characters 


_ The file has links 
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— The file is a directory 
— The file cannot be opened 


—~ No disk storage blocks will be saved by packing 


—~ A file called name.z already exists ry 


_ The .z file cannot be created 


— AnJ/Oerror occurred during processing 
The last segment of the filename must contain no more than 12 
characters to allow space for the appended .z extension. Directories 
cannot be compressed. 
Peat does for packed files what cat(C) does for ordinary files. The 
specified files are unpacked and written to the standard output. Thus 
to view a packed file named name.z use: 

peat name.z 


or just: 


pcat name 


To make an unpacked copy, say nnn, of a packed file named name.z “Aa 


(without destroying name.z) use the command: 


peat name >nnn 


Peat returns the number of files it was unable to unpack. Failure 
may occur if: 


— The filename (exclusive of the .z) has more than 12 characters 
— The file cannot be opened 
— The file does not appear to be the output of pack 


Unpack expands files created by pack. For each file name specified 
in the command, a search is made for a file called name.z (or just 
name, if name ends in .z). If this file appears to be a packed file, it 
is replaced by its expanded version. The new file has the .z suffix 
stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 


Unpack returns a value that is the number of files it was unable to ‘y 
unpack. Failure may occur for the same reasons that it may in peat, 

as well as in a file where the ‘‘unpacked’’ name already exists, or if 

the unpacked file cannot be created. 
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Name 


passwd — Changes login password. 


Syntax 


pass wd name 


Description 


This command changes (or installs) a password associated with the 
login name. 


The program prompts for the old password (if any) and then for the 
new one (twice). The user must supply these. Passwords can be of 
any reasonable length, but only the first eight characters of the pass- 
word are significant. The minimum number of characters allowed in 
a new password is determined by the PASSLENGTH variable. 
Although the minimum can be 3, a minimum of 5 characters is 
strongly recommended since passwords shorter than this are much 
easier to guess or discover by trial and error. 


Only the owner of the name or the super-user may change a pass- 
word; the owner must prove he knows the old password. Only the 
super-user can create a null password. 


The password file is not changed if the new password is the same as 
the old password, or if the password has not ‘‘aged’’ sufficiently; see 


pasewd(M)). 


The minimum length of a legal password, and the minimum and 
maximum number of weeks used in password aging are specified in 
/etc/default/passwd by the variables PASSLENGTH, MINWEEKS and 
MAXWEEKS. If not explicitly set, the default values for these vari- 
ables are: 


PASSLENGTH =5 
MINWEEKS=2 
MA XWEEKS=4 


MINWEEKS and MAXWEEKS values must be in the range 0 to 63. If 
PASSLENGTH is not in the range 3 to 8, it is set to 5. 


Files 


/etc/default/passwd 
/etc/passwd 


See Also 


login(M), pwadmin(C), crypt({S), default(M), passwd{M) 
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CLKT Countdown for alarm(S) measured in seconds. 


— u hezaddr 
Print information about a user process; the hezaddr argu- 
ment is its hexadecimal address. The octal form of this 
address can be displayed using the ps(C) command; it 
must be converted to hexadecimal before use with the — u 
option. The user process must be in main memory, or the 
file used can be a core image and the address 0. 


— c corefile 
Use the file corefile in place of /dev/mem. 


— n nameltat 
Use the file namelist as an alternate namelist in place of 
/xenix. 


—f Print the open file table with these headings: 
LOC The core location of this table entry. 
FLG Miscellaneous state variables encoded thus: 
R Open for reading 
W_ Open for writing 
P_ Pipe 
CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 


OFFS The file offset, see lseek(S). a. 


/xenix Namelist 


Files 


/dev/mem Default source of tables 


See Also 


ps(C), stat(S), filesystem(F) 
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—nck Provides k-digit line numbering (default for k is 5). The 
number occupies the first k+1 character positions of each 
column of normal output or each line of — m output. If ¢ 
(any nondigit character) is given, it is appended to the line 
number to separate it from whatever follows (default for ¢ is 
a tab). 


— wk Sets the width of a line to & character positions (default is 72 
for equal-width multicolumn output, no limit otherwise). 


— ok Offsets each line by k character positions (default is 0). The 
number of character positions per line is the sum of the 
width and offset. 


—Ilk Sets the length of a page to k lines (default is 66). 


—h Uses the next argument as the header to be printed instead 
of the filename. 


—p Pauses before beginning each page if the output is directed 
to a terminal (pr will ring the bell at the terminal and wait 
for a carriage return). 


—f Uses form feed character for new pages (default is to use a 
sequence of linefeeds). Pauses before beginning the first 
page if the standard output is associated with a terminal. 


—r Prints no diagnostic reports on failure to open files. 


—t Prints neither the 5-line identifying header nor the 5-line 
trailer normally supplied for each page. Quits printing after 
the last line of each file without spacing to the end of the 


page. 


— sc Separates columns by the single character ¢ instead of by the 
appropriate number of spaces (default for ¢ is a tab). 


Examples 


The following prints file and file2 as a double-spaced, three-column 
listing headed by ‘‘file list’’: 


pr — 3dh "file list” filel file2 


& The following writes filel on file2, expanding tabs to columns 10, 
19, 28. 37, ...: 


pr —- e9 —- t <filel >file2 
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See Also 


cat( C) 
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Name 


PS(C) 


ps — Reports process status. 


Syntax 


ps [ options | 


Description 


Ps prints certain information about active processes. Without 
options, information is printed about processes associated with the 


current term 
controlled by 


=e 


_d 


— | 


c corefile 


Ss swapdev 


— n nameltst 


— t tlrat 


— p plist 


June 8, 1984 


inal. Otherwise, the information that is displayed is 
the following options: 


Prints information about all processes. 


Prints information about all processes, except process 
group leaders. 


Prints information about all processes, except process 
group leaders and processes not associated with a termi- 
nal. 


Generates a full listing. (Normally, a short listing con- 
taining only process ID, terminal (‘‘tty’’) identifier, 
cumulative execution time, and the command name is 
printed.) See below for meaning of columns in a full 
listing. 


Generates along listing. See below. 
Uses the file corefile in place of /dev/mem 


Uses the file swapdev in place of /dev/swap. This is 
useful when examining a corefie. 


The argument is taken as the name of an alternate 
namelist (/xenix is the default). 


Restricts listing to data about the processes associated 
with the terminals given in tltst, where tist can be in 
one of two forms: a list of terminal identifiers separated 
from one another by a comma, or a list of terminal 
identifiers enclosed in double quotes and separated 
from one another by a comma and/or one or more 
spaces. 


Restricts listing to data about processes whose process 


ID numbers are given in pltst, where plist is in the same 
format as Utst. 
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— u ultst 


— g glist 


PS(C) 


Restricts listing to data about processes whose user ID 
numbers or login names are given in ulist, where ultst 
is in the same format as dst. In the listing, the numer- 
ical user ID is printed unless the — f option is used, in 
which case the login name is printed. 


Restricts listing to data about processes whose process 
groups are given in glist, where gltst is a list of process 
group leaders and is in the same format as dust. 


The column headings and the meaning of the columns in a pa listing 
are given below; the letters f and | indicate the option (full or long) 
that causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options only determine 
what information is provided for a process; they do not determine 
which processes will be listed. 


F 


WCHAN 
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A status word consisting of flags associated with 
the process. Each flag is associated with a bit in 
the status word. These flags are added to form a 
single octal number. Process flag bits and their 
meanings are: 

01 in core; 

02 system process; 

04 locked in core (e.g., for physical I/O); 

10 being swapped; 

20 being traced by another process. 
The state of the process: 

0 non-existent; 

S sleeping; 

WwW waiting; 

R running; 

: intermediate; 

Z terminated; 

g stopped. 
The user ID number of the process owner; the 
login name is printed under the — f option. 
The process ID of the process; it is possible to kill a 
process if you know this datum. 
The process ID of the parent process. 
Processor utilization for scheduling. 
Starting time of the process. 
The priority of the process; higher numbers mean 
lower priority. 
Nice value; used in priority computation. 
The memory address of the process, if resident; 
otherwise, the disk address. 
The size in blocks of the core image of the process, 
but not including the size of text shared with other 
processes. Since this size includes the current size 
of the stack, it will vary as the stack size varies. 
The event for which the process is waiting or sleep- 
ing; if blank, the process is running. 
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TTY (all) The controlling terminal for the process. 
TIME (all) The cumulative execution time for the process. 
CMD all) The command name; the full command name and 


its arguments are printed under the — f option. 


A process that has exited and has a parent, but has not yet been 
waited for by the parent, is marked <defunct>. 


Under the — f option, ps tries to determine the command name and 
arguments given when the process was created by examining 
memory or the swap area. Failing this, the command name, as it 
would appear without the — f option, is printed in square brackets. 


Files 
/xenix system namelist 
/dev/mem memory 
/dev searched to find swap device and terminal ((‘‘tty’’) 
names. 
See Also 


kill(C), nice(C) 


we Notes 


Things can change while ps is running; the picture it gives Is only a 
close approximation to reality. 


Some data printed for defunct processes are irrelevant. 
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Name 


pstat — Reports system information. 


Syntax 


pstat [| — aixpf ] [ — u hexaddr ] [ — c corefile ] [ — n namelist | [ 
file 


Description 
Petat interprets the contents of certain system tables. If file is given, 


the tables are sought there, otherwise in /dev/fmem. The required 
namelist is taken from /rentz. Options are: 


—a Under — p, describe all process slots rather than just active 
ones. 
—1 Print the inode table with the these headings: 


LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

Locked 

Update time filesystem(F) must be corrected 

Access time must be corrected 

File system is mounted here 

Wanted by another process (L flag is on) 

Contains a text file 

Changed time must be corrected 

CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in 
which this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod(S). 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 
Number of bytes in an ordinary file, or major and 
minor device of special file. 


QHsZpar 


— x Prints the text table with these headings: 
LOC The core location of this table entry. 
FLAGS Miscellaneous state variables encoded thus: 


T  ptrace(S) in effect 
W_ Text not yet written on swap device 
L Loading in progress 
K Locked 
w Wanted (L flag is on) 
DADDR 
Disk address in swap, measured in multiples of 
BSIZE bytes. 
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CADDR 
Core address, measured in units of memory 
management resolution. 

SIZE Size of text segment, measured in units of 
memory management resolution. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text seg- 


ment. 
—p Prints process table for active processes with these head- 
ings: 
LOC The core location of this table entry. 
S Run state encoded thus: 
0 No process 
1 Waiting for some event 
3 Runnable 
4 Being created 
5 Being terminated 
6 Stopped under trace 
F Miscellaneous state variables, ORed together: 
01 Loaded 
02 The scheduler process 
04 Locked 
010 Swapped out 
020 Traced 
040 Used in tracing 
0100 


Locked in by lock(S). 
PRI Scheduling priority, see nice(S). 
SIGNAL 
Signals received (signals 1-16 coded in bits 0-15), 
UID Real user ID. 


TIM Time resident in seconds; times over 127 coded as 
(eh 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see ntce(S). 


PGRP_ Process number of root of process group (the 
opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the physical address of the ‘‘u-area’’ of 
the process measured in units of memory 
management resolution. If swapped out, the posi- 
tion in the swap area measured in multiples of 


BSIZE bytes. 

SIZE Size of process image, measured in units of 
memory management resolution. 

WCHAN 


Wait channel number of a waiting process. 

LINK Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table 
entry. 
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CLKT Countdown for alarm(S) measured in seconds. 


u hezaddr 
Print information about a user process; the hezraddr argu- 
ment is its hexadecimal address. The octal form of this 
address can be displayed using the ps(C) command; it 
must be converted to hexadecimal before use with the — u 
option. The user process must be in main memory, or the 
file used can be a core image and the address 0. 


c corefile 
Use the file corefile in place of /dev/mem. 


n nameltet 
Use the file namelist as an alternate namelist in place of 
/xenix. 


—f Print the open file table with these headings: 
LOC The core location of this table entry. 
FLG Miscellaneous state variables encoded thus: 
R_ Open for reading 
W_ Open for writing 
P_ Pipe 
CNT Number of processes that know this open file. 
INO The location of the inode table entry for this file. 


OFFS The file offset, see Iseek(S). om 


/xenix Namelist 


Files 


/dev/mem Default source of tables 


See Also 


ps(C), stat(S), filesystem(F) 
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Name 
pwadmin — Performs password aging administration. 
Syntax 


pwadmin — dcfan [ — min weeks] [ — max weeks] user 


Description 


Pwadmuin is used to examine and modify the password aging informa- 
tion in the password file. The options one can specify are as follows: 


—d Displays the password aging information. 


f Forces the user to change his password at the next login. 
— Cc Prevents the user from changing his password. 
a 


Enables password aging for the given user. This option sets 
the minimum number of weeks that the user must wait 
before changing his password and the maximum number of 
weeks that a user can keep his current password to the 
values defined by the MINWEEKS and MAXWEEKS variables 
in the /etc/default/passwd file. If the file is not found or 
the defined values are not in the range 0 to 63, the default 
values 2 and 4 are used. 


—n Disables the password aging feature. 
YY — min weeks 
Enables password aging and sets the minimum number of 


weeks before the user can change his password to weeks. 
(This prevents him from changing his password back to the 
old one). 


— max weeks 
Enables password aging and sets the number of weeks that 
the user can keep his current password to weeks. 


Files 
/etc/passwd 
See Also 


passwd(C), passwd(M) 


Notes 
The user must not attempt to force a new password by setting both 
the — min and — max values to zero. To force a password, use the 
— f option. 


The user must not attempt to prevent further password changes by 
setting the — min value greater than the — max value. To prevent 
changes, use the — c option. 
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Name 


pwcheck — Checks password file. 


Syntax 


pwcheck [| file] ry 


Description 


Pwceheck scans the password file and checks for any inconsistencies. 
The checks include validation of the number of fields, login name, 
user ID, group ID, and whether the login directory and optional pro- 
gram name exist. The default password file is /etc/passwd. 


Files 


/etc/passwd 


See Also 


grpcheck(C), group(M), passwd(M) 
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Name 


pwd -— Prints working directory name. 


Syntax 


pwd 


Description 


Pwd prints the pathname of the working (current) directory. 


See Also 


cd(C) 


Diagnostics 


1) 33 


‘Cannot open ..’’ and ‘‘Read error in ..’’ indicate possible file sys- 
tem trouble. In such cases, see the Xentz Operations Gutde for infor- 
mation on fixing the file system. 
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Name 


quot — Summarizes file system ownership. 


Syntax 
quot [ option ] ... [ filesystem | 
Description 


Quot prints the number of blocks in the named filesystem currently 
owned by each user. If no filesystem is named, the file systems given 
in /etc/mnttab are examined. 


The following options are available: 


— n Causes the following pipeline to produce a list of all files and 
their owners: 


ncheck filesystem |sort + On |quot — n filesystem 


—c Prints three columns giving file size in blocks, number of files of 
that size, and cumulative total of blocks in that size or smaller 
file. Data for files of size greater than 499 blocks are included 
in the figures for files of exactly size 499. a 


—f Prints count of number of files as well as space owned by each 


user. 
Files 
/etc/passwd Gets user names 
/etc/mnttab Contains list of mounted file systems 
See Also 


du(C), Is(C) 


Notes 


Holes in files are counted as if they actually occupied space. 


See also Notes under mount(C). 
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Name 


random — Generates a random number. 


Syntax 


random [— s] [ scale ] 


Description 


Random generates a random number on the standard output. and 
returns the number as its exit value. By default this number is 
either 0 or 1, 1.e., scale is 1 by default. If scale is given a value 
between 1 and 255, then the range of the random value is from 0 to 
scale. If scale is greater than 255 an error message is printed. 


With the — s ‘‘silent’’ option is given, then the random number is 


returned as an exit value but is not printed on the standard output. 
If an error occurs, random returns an exit value of zero. 


See Also 


Y ran d( S) 


Notes 


This command does not perform any floating point computations. 


Random uses the time of day as a seed. 
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Name 


rcp — Copies files across XENIX systems. 


Syntax 


rcp [ options | [srcmachine:]srcfile [destmachine:] destfile ry 


Description 


Rep copies files between systems in a Micnet network. The com- 
mand copies the srmachine:srcfile to destmachine-destfile, where 
srcmachine: and destmachine: are optional names of systems in the 
network, and arcfile and destfille are pathnames of files. If a machine 
name is not given, the name of the current system is assumed. If — 
is given in place of ercfile, rep uses the standard input as the source. 
Directories named on the destination machine must be publicly writ- 
able, and directories and files named on a remote source machine 
must be publicly readable. 


The available options are: 
—m 


Mails and reports completion of the command, whether there is “A 


an error or not. 


— ul machine:| user 
Any mail goes to the named user on machine. The default 
machine is the machine on which rep is invoked. 


Rep is useful for transferring small numbers of files across the net 
work. The network consists of daemons that periodically awaken 
and send files from one system to another. The network must be be 
installed using netutd(C) before rep can be used. Also, to enable 
transfer of files from a remote system, the line 


rcp=/usr/bin/rcp 


must be added to the default file Atc/defaultfnicnet on the systems in 
the network. 


Example 


rcp — m machinel:/etc/mnttab /tmp/vtape ry 


See Also 


netutil(C), remote(C), mail(C), micnet(M) 
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Diagnostics 


If an error occurs mai! is sent to the user. 


\& Notes 
Full pathnames must be specified for remote files. 


Rep handles binary data files transparently, no extra options or pro- 
tocols are needed to handle them. Wildcards are not expanded on 
the remote machine. 
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Name 


remote — Executes commands on a remote XENIX system. 
Syntax 


remote [ — ] [ — f file ] [- m] [ - u user] machine ty 


command [ arguments |] 


Description 


Remote is a limited networking facility that permits execution of 
XENIX commands across serial lines. Commands on any connected 
system may be executed from the host system using remote. A com- 
mand line consisting of command and any blank-separated arguments 
is executed on the remote machine. A machine’s name is located in 
the file /etc/systemid. Note that wild cards are not expanded on the 
remote machine, so they should not be specified in arguments. ID. 
The optional — m switch causes mail to be sent to the user telling 
whether the command is successful. 


The available options follow: 


~ A dash signifies that standard input is used as the stan- 
dard input for command on the remote machine. Standard 
input comes from the local host and not from the remote 
machine. 


— f file Use the specified file as the standard input for command 
on the remote machine. The file exists on the local host 
and not on the remote machine. 


—m Mails the user to report completion of the command. By 
default, mail reports only errors. 


—u Any report mail goes to the named user rather than to 
the executor of the command. The user name may have 
a prepending machine name to signify a user on some 
remote system. 


Before remote can be successfully used, a network of systems must 
first be set up and the proper daemons initialized using netutil(C). 
Also, entries for the command to be executed using remote must be 


added to the /etc/default/micnet files on each remote machine. ry 
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Ex ample 


The following command executes an le command on the directory 
/tmp of the machine machine1: 


remote machinel ls /tmp 


See Also 


rcp(C), mail(C), netutil(C), micnet(M) 


Notes 


The mad command uses the equivalent of remote to send mail 
between machines. 
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Name 


restor — Invokes incremental file system restorer. 


Syntax 


restor key | arguments | ry 


Description 


Restor is used to read archive media backed up with the dump com- 
mand. The key specifies what is to be done. Key is one of the char- 
acters rRxt, optionally combined with f. 


f Uses the first argument as the name of the archive instead of the 
default. 


r,R The archive is read and loaded into the file system specified in 
argument. This should not be done lightly (see below). If the 
key is R, restor asks which archive of a multivolume set to start 
on. This allows restor to be interrupted and then restarted (an 
feck must be done before the restart). 


x Each file on the archive named by an argument is extracted. 
The filename has all ‘‘mount’’ prefixes removed; for example, if 
/usr is a mounted file system, /usr/bin/Ipr is named /bin/Ipr 
on the archive. The extracted file is placed in a file with a 
numeric name supplied by restor (actually the inode number). 
In order to keep the amount of archive read to a minimum, the 
following procedure is recommended: 


1. Mount volume 1 of the set of backup archives. 
2. Type the restor command. 


3. Restor will announce whether or not it found the files, give 
the numeric name that it will assign to the file, and in the 
case of a tape, rewind to the start of the archive. 


4. It then asks you to ‘‘mount the desired tape volume’’. 
Type the number of the volume you choose. On a multivo- 
lume backup the recommended procedure is to mount the 
last through the first volumes, in that order. Restor checks 
to see if any of the requested files are on the mounted 
archive (or a later archive— thus the reverse order). If the “ 
requested files are not there, restor doesn’t read through the 
tape. If you are working with a single-volume backup or if 
the number of files being restored is large, respond to the 


query with 1 and restor will read the archives in sequential 
order. 
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t Prints the date the archive was written and the date the file sys- 
tem was backed up. 


The r option should only be used to restore a complete backup 
archive onto a clear file system, or to restore an incremental backup 


rw) archive onto a file system so created. Thus: 
/etc/mkfs /dev/hd1 10000 


restor r /dev/hdl 


is a typical sequence to restore a complete backup. Another restor 
can be done to get an incremental backup in on top of this. 


A dump followed by a mkfe and a restor is used to change the size of 


a file system. 

Files 
rst* Temporary files 
/etc/default/dump Name of default archive device 


The default archive unit varies with installation. 


YY See Also 


dump(C), fsck(C), mkfs(C) 


Diagnostics 
There are various diagnostics involved with reading the archive and 
writing the disk. There are also diagnostics if the i-list or the free 
list of the file system is not large enough to hold the dump. 
If the dump extends over more than one disk or tape, it may ask 
you to change disks or tapes. Reply with a newline when the next 
unit has been mounted. 


Notes 


It is not possible to successfully restor an entire active root file sys- 


& a 
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Name 
rm, rmdir — Removes files or directories. 

Syntax ry 
rm [ — fri | file ... 
rmdir dir ... 

Description 


Rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 


If a file has no write permission and the standard input is a terminal, 
its permissions are printed and a line is read from the standard input. 
If that line begins with y the file is deleted, otherwise the file 
remains. No questions are asked when the — f option is given or if 
the standard input is not a terminal. 


If a designated file is a directory, an error comment is printed unless 
the optional argument — r has been used. In that case, rm recur- “mY 
sively deletes the entire contents of the specified directory, and the 
directory itself. 


If the — i (interactive) option is in effect, rm asks whether to delete 
each file, and if the — r option is in effect, whether to examine each 
directory. 


Rmdir removes empty directories. 


See Also 


rmdir(C) 


Diagnostics 


Generally self-explanatory. It is forbidden to remove the file .. to 
avoid the consequences of inadvertently doing something like: 


rmio=- 5 ;* a 


It is also forbidden to remove the root directory of a given file sys- 
tem. 


No more than 17 levels of subdirectories can be removed using the 
— r option. 
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Name 


rmdir — Removes directories. 


Syntax 


rmdir dir ... 


Description 


Rm removes the entries for one or more subdirectories from a direc- 
tory. A directory must be empty before it can be removed. Rmair 
enforces a standard and safe procedure for removing a directory; the 
contents of the directory must be removed before the directory itself 
can be deleted with rmdir. Note that the ‘‘rm -r dir’ command is a 
more dangerous alternative to rmdir. 


Rmdir removes entries for the named directories, which must be 
em pty. 
See Also 


rm(C) 


YU Notes 


Rmdir will refuse to remove the root directory of a mounted file sys- 
tem. 
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Name 


rmuser — Removes auser from the system. 


Syntax ry 
/etc /rmuser 


Description 


Rmuser removes users from the system. It begins by prompting for 
a user name; after receiving a valid user name as a response, it then 
deletes the named user’s entry in the password file, and removes the 
user’s mailbox file, the .profile file, and the entire home directory. It 
will also remove the users group entry in /etc/group if the user was 
the only remaining member of that group, and the group ID was 
greater than 50. 


Before removing a user ID from the system, make sure its mailbox is 
empty and that all files belonging to that user ID have been saved or 
deleted as required. 


The rmueer program will refuse to remove a user ID or any of its 
files if one or more of the following checks fails: 


— The user name given is one of the ‘‘system’’ user names such 
as root, sys, sysinfo, cron, or uucp. All user IDs less than 200 
are considered reserved for system use, and cannot be removed 
using rmuser. Likewise all group IDs less than 50 are not 
removable using rmueer. 

— The user’s mailbox exists and is not empty. 


— The user’s home directory contains files other than .profile. 


FRmuser can only be executed by the super- user. 


Files 
/etc/passwd 
/usr/spool/mail/username 


$HOME 


See Also 


mkuser(C), dump(C) 
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Name 


rsh — Invokes a restricted shell (command interpreter). 


Syntax 


rsh [ flags ] [ name [ arg] ... | | 


Description 


Reh is a restricted version of the standard command interpreter 
sh(C). It is used to set up login names and execution environments 
whose capabilities are more controlled than those of the standard 
shell. The actions of rsh are identical to those of sh, except that 
changing directory with cd, setting the value of $PATH, using com- 
mand names containing slashes, and redirecting output using > and 
>> are all disallowed. 


When invoked with the name — rsh, reh reads the user’s .profile 
(from $HOME/.profile). It acts as the standard sh while doing this, 
except that an interrupt causes an immediate exit, instead of causing 
a return to command level. The restrictions above are enforced after 
-profile is interpreted. 


When a command to be executed is found to be a shell procedure, 
rsh invokes 8h to execute it. Thus, it is possible to provide to the 
end user shell procedures that have access to the full power of the 
standard shell, while restricting him to a limited menu of commands; 
this scheme assumes that the end user does not have write and exe- 
cute permissions in the same directory. 


The net effect of these rules is that the writer of the .profile has 
complete control over user actions, by performing guaranteed setup 
actions, then leaving the user in an appropriate directory (probably 
not the login directory). 


Reh is actually just a link to sh and any flags arguments are the same 
as for sh(C). 


The system administrator often sets up a directory of commands that 
can be safely invoked by rsh. 


See Also 
& sh(C), profile(M) 
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Name 


sddate — Prints and sets backup dates. 


Syntax 


sddate [ name lev date | 


Description 


If no argument is given, the contents of the backup date file 
‘*/etc/ddate’’ are printed. The backup date file is maintained by 
dump(C) and contains the date of the most recent backup for each 
backup level for each filesystem. 


If arguments are given, an entry is replaced or made in 
‘‘/etc/ddate’’. name is the last component of the device pathname. 
lev is the backup level number (from 0 to 9), and date is a time in 
the form taken by date(C): 


mmddhhmm|yy] 


Where the first mm is a two-digit month in the range 01-12, ddis a 
two-digit day of the month, AA is a two-digit military hour from 00- 
23, and the final mm is a two-digit minute from 00-59. An optional 
two-digit year, yy, is presumed to be an offset from the year 1900, 
1.e., 19 yy. 


Some sites may wish to back up file systems by copying them verba- 
tim to backup media. Sddate could be used to make a ‘‘level 0”’ 
entry in ‘‘/etc/ddate’’, which would then allow incremental backups. 
For example: 


sddate rhd0 5 10081520 


makes an ‘‘/etc/ddate’’ entry showing a level 5 backup of 
‘*/dev/rhd0”’ on October 8, at 3:20 PM. 


Files 


/etc/ddate 
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See Also 


dump(C), date(C) 


& Diagnostics 
bad conversion If the date set is syntactically incorrect. 
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Name 


sdiff - Compares files side-by-side. 


Syntax 


sdiff { options ... | filel file2 


Description 


Sdiff uses the output of diff(C) to produce a side-by-side listing of 
two files indicating those lines that are different. Each line of the 
two files is printed with a blank gutter between them if the lines are 
identical, a < in the gutter if the line only exists in file1, a > in the 
gutter if the line only exists in file2, and a | for lines that are 
different. 


For example: 


x | y 
a a 
b Xe 
c 
d d 
c 
The following options exist: 
—wn Uses the next argument, n, as the width of the output 


line. The default line length is 130 characters. 
ae | Only prints the left side of any lines that are identical. 
—s Does not print identical lines. 


—o output Uses the next argument, output, as the name of a third 
file that is created as a user-controlled merging of file! 
and file2. Identical lines of file1 and file2 are copied to 
output. Sets of differences, as produced by diff(C), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
sdiff prompts the user with a %and waits for one of the 
following user-typed commands: 


1  Appends the left column to the output file 


r Appends the right column to the output file 


s Turns on silent mode; does not print ident- 
ical lines 
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v Turns off silent mode 

e 1 Calls the editor with the left column 
e r Calls the editor with the right column 
e b 


Calls the editor with the concatenation of 
left and right 


e Calls the editor with a zero length file 


q__s Exits from the program 


On exit from. the editor, the resulting file is concatenated 
on the end of the output file. 


See Also 
diff(C), ed(C) 


. " 
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Name 


sed— Invokes the stream editor. 


Syntax 


sed [ — n] [-—e script] [ — f sfile ] [ files ] 


Description 


Sed copies the named files (standard input default) to the standard 
output, edited according to a script of commands. The — f option 
causes the script to be taken from file sfile; these options accumu- 
late. If there is just one — e option and no — f options, the flag — e 
may be omitted. The — n option suppresses the default output. A 
script consists of editing commands, one per line, of the following 
form: 


[ address | , address | ] function [ arguments ] 


In normal operation, sed cyclically copies a line of input into a pat- 
tern epace (unless there is something left after a D command), 
applies in sequence all commands whose addresses select that pattern 
space, and at the end of the script copies the pattern space to the 
standard output (except under — n) and deletes the pattern space. 


Some of the commands use a hold space to save all or part of the 
pattern space for subsequent retrieval. 


An address is either a decimal number that counts input lines cumu- 
latively across files, a $ that addresses the last line of input, or a con- 
text address, i.e., a /regular ezpression/ in the style of ed(C) 
modified as follows: 


— In a context address, the construction \?regular ezpression?, 
where ? is any character, is identical to /regular ezpression/. 
Note that in the context address \xabc\xdefx, the second x 
stands for itself, so that the regular expression is abcxdef. 


— The escape sequence \n matches a newline embedded in the pat 
tern space. 


— A period . matches any character except the terminal newline of 
the pattern space. 


— A command line with no addresses selects every pattern space. ry 


— A command line with one address selects each pattern space that 
matches the address. 
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— A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address 
through the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line 
number first selected, only one line is selected.) Thereafter the 
process is repeated, looking again for the first address. 


we Editing commands can be applied only to nonselected pattern spaces 


by use of the negation function ! (below). 


In the following list of functions the maximum number of permissi- 
ble addresses for each function is indicated in parentheses. 


The tezt argument consists of one or more lines, all but the last of 
which end with backslashes to hide the newlines. Backslashes in text 
are treated like backslashes in the replacement string of an s com- 
mand, and may be used to protect initial blanks and tabs against the 
stripping that is done on every script line. The rfile or wfile argu- 
ment must terminate the command line and must be preceded by 
exactly one blank. Each wfile is created before processing begins. 
There can be at most 10 distinct wfile arguments. 


(1) a\ 
tert Appends tezt, placing it on the output before reading the 
next input line. 


(2) blabel Branches to the : command bearing the label. If label is 
empty, branches to the end of the script. 


(2) c\ 

tert Changes text by deleting the pattern space and then 
appending tezt. With 0 or 1 address or at the end of a 2- 
address range, places tert on the output and starts the 


next cycle. 
(2) d Deletes the pattern space and starts the next cycle. 
(2) D Deletes the initial segment of the pattern space through 
the first newline and starts the next cycle. 
(2)¢g Replaces the contents of the pattern space with the con- 
tents of the hold space. 
(2) G Appends the contents of the hold space to the pattern 
space. 
, 
& eae Replaces the contents of the hold space with the contents 
of the pattern space. 
(2) H Appends the contents of the pattern space to the hold 
space. 
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tert Insert. Places tert on the standard output. 


(2) 1 Lists the pattern space on the standard output with non- 


printing characters spelled in two-digit ASCII and long 
lines folded. 


(2)n Copies the pattern space to the standard output. Replaces 
the pattern space with the next line of input. 

(2) N Appends the next line of input to the pattern space with 
an embedded newline. (The current line number 
changes.) 

(2) p Prints (copies) the pattern space on the standard output. 

(2) P Prints (copies) the initial segment of the pattern space 


through the first newline to the standard output. 


(1) q Quits sed by branching to the end of the script. No new 
cycle is started. 


(2) rrfile Reads the contents of rfile and places them on the output 
before reading the next input line. 


(2) s/regular expression/replacement/flags 
Substitutes the replacement string for instances of the reg- 
ular expresston in the pattern space. Any character may 
be used instead of /. For a more detailed description see 
ed(C). Flags is zero or more of: 


g Globally substitutes for all nonoverlapping instances 
of the regular expression rather than just the first one. 


p Prints the pattern space if a replacement was made. 


w wfile 
Writes the pattern space to wfile if a replacement was 
made. 


(2) t label Branches to the colon (:) command bearing label if any 
substitutions have been made since the most recent read- 
ing of an input line or execution of at command. If label 
is empty, t branches to the end of the script. 


(2) w wfile 
Writes the pattern space to wfile. 


(2) x Exchanges the contents of the pattern and hold spaces. 


(2) y/string1/string2 / 
Replaces all occurrences of characters in string! with the 
corresponding characters in string2. The lengths of 
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string! and string? must be equal. 


(2)! function 
Applies the function (or group, if function is {) only to 
lines not selected by the address(es). 


(0): label This command does nothing; it bears a label for b and t 
commands to branch to. 


(1) = Places the current line number on the standard output as 
a line. 
(2) { Executes the following commands through a matching } 
only when the pattern space is selected. 
(0) An empty command is ignored. 
See Also 


awk(C), ed(C), grep(C) 
The XENIX Tezt Processing Guide 
Notes 


YY This command is more fully documented in the XENIX Tezt Process- 
ing Guide. 


March 24, 1984 Page 4 


SETMNT(C) SETMNT(C) 


Name 


setmnt-— Establishes /etc/mnttab table. 


Syntax 


/etc/setmnt 


Description 
Setmnt creates the /etc/mnttab table (see mnttab(F)), which is 
needed for both the mount(C) and umount(C) commands. Setmnt 
reads the standard input and creates a mnttab entry for each line. 
Input lines have the format: 
filesys node 
where filesys is the name of the file system’s special file (e.g., 


‘‘hd0’’) and node is the root name of that file system. Thus filesye 
and node become the first two strings in the mnttab(F) entry. 


Files 


/etc/mnttab Mm 


See Also 


m nttab(F) 


Notes 
If filesys or node are longer than 128 characters errors can occur. 


Setmnt silently enforces an upper limit on the maximum number of 
mnttab entries. 


Setmnt is normally invoked by /etc/re when the system boots up. 
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Name 


settime — Changes the access and modification dates of files. 


Syntax 


settime mmddhhmm [ yy ] [ — f fname ] name ... 


Description 


Sets the access and modification dates for one or more files. The 
dates are set to the specified date, or to the access and modification 
dates of the file specified via — f. Exactly one of these methods 
must be used to specify the new date(s). The first mm is the month 
number; dd is the day number in the month; hh is the hour number 
(24 hour system); the second mm is the minute number; yy is the 
last two digits of the year and is optional. For example: 


settime 1008004583 ralph pete 


sets the access and modification dates of files ralph and pete to Oct 8, 
12:45 AM, 1983. Another example: 


settime — f ralph john 


YY This sets the access and modification dates of the file zohn to those 
of the file ralph. 


Notes 


Use of touch in place of settime is encouraged. 
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Name 


sh —- Invokes the shell command interpreter. 


Syntax 


sh [ — ceiknrstuvx | [ args ] 


Description 


The shell is the standard command programming language that exe- 
cutes commands read from a terminal ora file. See /nvocation below 
for the meaning of arguments to the shell. 


Commands 


A simple-command is a sequence of nonblank worde separated by 
blanks (a blank is a tab or a space). The first word specifies the 
name of the command to be executed. Except as specified below, 
the remaining words are passed as arguments to the invoked com- 
mand. The command name is passed as argument 0 (see ezec(S)). 
The value of a simple-command is its exit status if it terminates nor- 


mally, or (octal) 200+ status if it terminates abnormally, i.e., if the % 


failure produces a core file. See signal(S) for a list of status values. 


A ptpeline is a sequence of one or more commands separated by a 
vertical bar (}. (The caret (*) also has the same effect.) The stan- 
dard output of each command but the last is connected by a mpe(S) 
to the standard input of the next command. Each command is run 
as a separate process; the shell waits for the last command to ter- 
m inate. 


A list is a sequence of one or more pipelines separated by ;, & &&, 
or || and optionally terminated by ; or & Of these four symbols, ; 
and & have equal precedence, which is lower than that of && and || 
The symbols && and ||also have equal precedence. A semicolon (;) 
causes sequential execution of the preceding pipeline; an ampersand 
(&) causes asynchronous execution of the preceding pipeline (i.e., 
the shell does not wait for that pipeline to finish). The symbol && 
(|) causes the list following it to be executed only if the preceding 
pipeline returns a zero (nonzero) exit status. An arbitrary number 
of newlines may appear in a ltst, instead of semicolons, to delimit 
commands. 


A command is either a simple-command or one of the following 
commands. Unless otherwise stated, the value returned by a com- 
mand is that of the last simple-command executed in the command: 
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for name { in word... | do list done 
Each time a for command is executed, name is set to the next 
word taken from the in word list. If inword is omitted, then the 
for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu- 
& tion ends when there are no more words in the list. 
case word in| pattern [| | pattern |...) list ;; | ... esac 
A case command executes the list associated with the first pat- 
tern that matches word. The form of the patterns is the same as 


that used for filename generation (see Filename Generation 


below). 


if dist then list [ elif list then list | ... [ else list ] fi 
The list following if is executed and, if it returns a zero exit 
status, the list following the first then is executed. Otherwise, 
the list following elif is executed and, if its value is zero, the list 
following the next then is executed. Failing that, the else I/tst is 
executed. If no else dist or then list is executed, then the if 
command returns a zero exit status. 


while list do list done 
A while command repeatedly executes the while /tst and, if the 
exit status of the last command in the list is zero, executes the 
do ltst; otherwise the loop terminates. If no commands in the 
do list are executed, then the while command returns a zero exit 
status; until may be used in place of while to negate the loop 
termination test. 


(list ) 
Executes l1st in a subshell. 


{list; } 


list is simply executed. 


The following words are only recognized as the first word of a com- 
mand and when not quoted: 


if then else elif fi case esac for while until do done { } 


Comments 


A word beginning with # causes that word and all the following 
characters up to a newline to be ignored. 


i Command Substitution 


The standard output from a command enclosed in a pair of grave 
accents ( **) may be used as part or all of a word; trailing newlines 
are removed. 
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Parameter Substitution 
The character $ is used to introduce substitutable parameters. Posi- 
tional parameters may be assigned values by set. Variables may be 
set by writing: 


name ==value [ name==value |... 


Patteru-matching is not performed on value. 


${parameter} 
A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, — , $, and!. 


The value, if any, of the parameter is substituted. The braces 
are required only when parameter is followed by a letter, digit, 
or underscore that is not to be interpreted as part of its name. 
A name must begin with a letter or underscore. If parameter is 
a digit then it is a positional parameter. If parameter is * or @, 
tien all the positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set from argument 
zero when the shell is invoked. 


${parameter:— word} 
If parameter is set and is nonnull then substitute its value; oth- 
erwise substitute word. 


${parameter:—=word} a 
If parameter is not set or is null, then set it to word; the value of 


the parameter is then substituted. Positional parameters may 
not be assigned to in this way. 


${parameter:? word} 
If parameter is set and is nonnull then substitute its value; oth- 
erwise, print word and exit from the shell. If word is omitted, 
then the message ‘‘parameter null or not set’’ is printed. 


${parameter:+ word} 
If parameter is set and is nonnull then substitute word; otherwise 
substitute nothing. 


In the above, word is not evaluated unless it is to be used as the 


substituted string, so that in the following example, pwd is executed 
only if dis not set or is null: 


echo ${d:— ‘pwd *} 


If the colon (:) is omitted from the above expressions, then the shell 
only checks whether parameter is set. 


The following parameters are automatically set by the shell: 


# The number of positional parameters in decimal 
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— Flags supplied to the shell on invocation or by the set command 


? The decimal value returned by the last synchronously executed 
command 


$ The process number of this shell 


! The process number of the last background command invoked 
The following parameters are used by the shell: 


HOME 
The default argument (home directory) for the ed command 


PATH 
The search path for commands (see Ezecution below) 


MAIL 
If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 


PS1 Primary prompt string, by default ‘‘$ ”’ 


PS2 Secondary prompt string, by default ‘‘> 


IFS Internal field separators, normally space, tab, and newline 


The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME te 
set by login(M)). 


Blank Interpretation 


After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS) and split into distinct arguments where such characters are 
found. Explicit null arguments (”” or ”7) are retained. Implicit null 
arguments (those resulting from parametere that have no values) are 
removed. 


Filename Generation 


Following substitution, each command word is scanned for the char- 
> acters *, ?, and [. If one of these characters appears then the word 
& is regarded as a pattern. The word is replaced with alphabetically 
sorted filenames that match the pattern. If no filename is found that 
matches the pattern, then the word is left unchanged. The character 
. at the start of a filename or immediately following a /, as well as 
the character / itself, must be matched explicitly. These characters 
and their matching patterns are: 
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Matches any string, including the null string. 
? Matches any single character. 
Matches any one of the enclosed characters. A pair of charac- 


ters separated by - matches any character lexically between the 
pair, inclusive. 


Quoting 


The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 


; & ( ) | * < > newline space tab 


A character may be quoted (i.e., made to stand for itself) by preced- 
ing it with a \. The pair \newline is ignored. All characters 
enclosed between a pair of single quotation marks ( ”7), except a 
single quotation mark, are quoted. Inside double quotation marks 
(””), parameter and command substitution occurs and \ quotes the 
characters \, *, ”, and $. "$*” is equivalent to "$1 $2 ...”, whereas 
‘*$@ ’’ is equivalent to "$1” "$2” .... 


Prompting ty 


When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, then the secondary 
prompt (i.e., the value of PS2) is issued. 


Input/Output 


Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command. They are not passed on to the invoked com- 
mand; substitution occurs before word or digit is used: 


< word Use file word as standard input (file descriptor 0). 
> word Use file word as standard output (file descriptor 1). 


If the file does not exist then it is created; otherwise, 
it is truncated to zero length. 


>> word Use file word as standard output. If the file exists 
then output is appended to it (by first seeking to the 
end-of-file); otherwise, the file is created. 
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<<[-— |word The shell input is read up to a line that is the same 
as word, or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character of 
word is quoted, then no interpretation is placed upon 
the characters of the document; otherwise, parameter 
and command substitution occurs, (unescaped) 
\newline is ignored, and \ must be used to quote the 
characters \, $, \, and the first character of word. If 


is appended to <<, then all leading tabs are 
stripped from word and from the document. 


< &digit The standard input is duplicated from file descriptor 
digit (see dup(S)). Similarly for the standard output 
using >. 

< &- The standard input is closed. Similarly for the stan- 


dard output using >. 


If one of the above is preceded by a digit, then the file descriptor 
created is that specified by the digit (instead of the default 0 or 1). 
For example: 


oareey eS | 
creates file descriptor 2 that is a duplicate of file descriptor 1. 
If a command is followed by & then the default standard input for 
the command is the empty file /dev/null. Otherwise, the environ- 


ment for the execution of a command contains the file descriptors of 
the invoking shell as modified by input/output specifications. 


Environment 


The environment (see environ(M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argu- 
ment list. The shell interacts with the environment in several ways. 
On invocation, the shell scans the environment and creates a param- 
eter for each name found, giving it the corresponding value. Exe- 
cuted commands inherit the same environment. If the user modifies 
the values of these parameters or creates new ones, none of these 
affects the environment unless the export command is used to bind 
the shell’s parameter to the environment. The environment seen by 
any executed command is thus composed of any unmodified name- 
value pairs originally inherited by the shell, plus any modifications or 


\Y additions, all of which must be noted in export commands. 


The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 


TERM=450 cmd args 
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and 
(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 


If the —k flag is set, all keyword arguments are placed in the 
environment, even if they occur after the command name. 


Signals 


The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by & otherwise signals have the 
values inherited by the shell from its parent, with the exception of 
signal 11 (but see also the trap command below). 


Execution 


Hach time a command is executed, the above substitutions are car- 
ried out. Except for the Special Commands listed below, a new pro- 
cess is created and an attempt is made to execute the command via 


ezec(S). 


containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin, and /usr/bin, in that order). Note that the 
current directory is specified by a null pathname, which can appear 
immediately after the equal sign or between the colon delimiters 
anywhere else in the path list. If the command name contains a / 
then the search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has execute per- 
mission but is not an a.out file, it is assumed to be a file containing 
shell commands. A subshell (i.e., a separate process) is spawned to 
read it. A parenthesized command is also executed in a subshell. 


The shell parameter PATH defines the search path for the directory “a 


Special Commands 


The following commands are executed in the shell process and, 
except as specified, no input/output redirection is permitted for such 
commands: 


No effect; the command does nothing. A zero exit code is 
returned. 


. file 
Reads and executes commands from file and returns. The 
search path specified by PATH is used to find the directory con- 
taining file. 
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break [ n | 
Exits from the enclosing for or while loop, if any. If n is 
specified then breaks n levels. 


continue [ n | 
YY Resumes the next iteration of the enclosing for or while loop. 


If n is specified then resumes at the n-th enclosing loop. 


cd[ arg | 
Changes the current directory to arg. The shell parameter 
HOME is the default arg. 


eval [ arg... | 
The arguments are read as input to the shell and the resulting 
command(s) executed. 


exec [ arg... | 
The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu- 
ments may appear and, if no other arguments are given, cause 
the shell input/output to be modified. 


exit [ n | 
Causes a shell to exit with the exit status specified by n. If n is 
omitted then the exit status is that of the last command exe- 
cuted (an end-of-file will also cause the shell to exit.) 


export [ name... | 
The given names are marked for automatic export to the 
environment of subsequently executed commands. If no argu- 
ments are given, a list of all names that are exported in this 
shell is printed. 


newgrp [ arg... ] 
Equivalent to exec newgrp arg.... 


read [ name... | 
One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 


readonly [ name... | 


The given names are marked readonly and the values of the 
these names may not be changed by subsequent assignment. If 


i no arguments are given, then a list of all readonly names is 
printed. 


set [| — ekntuvx [ arg... ] | 


—e lf the shell is noninteractive, exits immediately if a com- 
mand exits with a nonzero exit status. 
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k Places all keyword arguments in the environment for a 
command, not just those that precede the command name. 


— n Reads commands but does not execute them. 


— t Exits after reading and executing one command. Intended 
for use by C programs only; not useful interactively. 


— u Treats unset variables as an error when substituting. 
— v Prints shell input lines as they are read. 


— x Prints commands and their arguments as they are executed. 


Does not change any of the flags; useful in setting $1 to -. 


Using + rather than — causes these flags to be turned off. 
These flags can also be used upon invocation of the shell. The 
current set of flags may be found in $—. The remaining argu- 
ments are positional parameters and are assigned, in order, to 
$1, $2, .... If no arguments are given then the values of all 
names are printed. 


shift 
The positional parameters from $2... are renamed $1.... 

tes t 
Evaluates conditional expressions. See test(C) for usage and 
description. 

times 


Prints the accumulated user and system times for processes run 
from the shell. 


trap} arg } [ 2-|... 

arg is a command to be read and executed when the shell 
receives signal(s) n. (Note that arg is scanned once when the 
trap is set and once when the trap is taken.) Trap commands are 
executed in order of signal number. The highest signal number 
allowed is 16. Any attempt to set a trap on a signal that was 
ignored on entry to the current shell is ineffective. An attempt 
to trap on signal 11 (memory fault) produces an error. If arg is 
absent then all trap(s) n are reset to their original values. If arg 
is the null string then this signal is ignored by the shell and by 
the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no 
arguments prints a list of commands associated with each signal 
num ber. 
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umask [ 900 | 
The user file-creation mask is set to the octal number ooo where 
o is an octal digit (see umask(C)). If 000 is omitted, the current 
value of the mask is printed. 


wait 
& Waits for all child processes to terminate, and reports the termi- 
nation status. If n is not given then all currently active child 
processes are waited for. The return code from this command is 
always 0. 


Invocation 


If the shell is invoked through ezec(S) and the first character of 
argument 0 is — , commands are initially read from /etc/profile and 
then from $HOME/.profile, if such files exist. Thereafter, com- 
mands are read as described below, which is also the case when the 
shell is invoked as /bin/sh. The flags below are interpreted by the 
shell on invocation only; note that unless the — c or —s flag is 
specified, the first argument is assumed to be the name of a file con- 
taining commands, and the remaining arguments are passed as posi- 
tional parameters to that command file: 


—c string If the — c flag is present then commands are read from 
string. 


—s If the — s flag is present or if no arguments remain then 
commands are read from the standard input. Any 
remaining arguments specify the positional parameters. 
Shell output is written to file descriptor 2. 


— 1 If the — i flag is present or if the shell input and output 
are attached to a terminal, then this shell is tnteractive. In 
this case TERMINATE is ignored (so that kill 0 does not 
kill an interactive shell) and INTERRUPT is caught and 
ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 


—r If the — r flag is present the shell is a restricted shell (see 
rsh(C)). 


The remaining flags and arguments are described under the set com- 
mand above. 


iY Exit Status 
Errors detected by the shell, such as syntax errors, cause the shell to 


return a nonzero exit status. If the shell is being used noninterac- 
tively then execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed (see also 
the exit command above). 
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Files 
/etc/profile 
$HOME/.profile 
/imp/sh* 


/dev/null 


See Also 


cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 


Notes 


The command readonly (without arguments) produces the same 
output as the command export. 


If << is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* is created and the shell complains 
about not being able to find that file by another name. 
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Name 


shutdown — Terminates all processing. 


Syntax 


/etc/shutdown [ time ] [ su ] 


Description 


Shutdown is part of the XENIX operation procedures. Its primary 
function is to terminate all currently running processes in an orderly 
and cautious manner. The time argument is the number of minutes 
before a shutdown will occur; default is five minutes. The optional 
su argument lets the user go single-user, without completely shutting 
down the system. However, the system is shut down for multiuser 
use. Shutdown goes through the following steps. First, all users 
logged on the system are notified to log off the system by a broad- 
casted message. All file system super-blocks are updated before the 
system is stopped (see sync(C)). This must be done before reboot- 
ing the system, to insure file system integrity. 


YY See Also 
sync(C), umount{C), wall(C) 


Diagnostics 


The most common error diagnostic that will occur is device busy. 
This diagnostic appears when a particular file system could not be 
unmounted. See umount(C). 


Notes 


Once shutdown has been invoked it must be allowed to run to com- 
pletion and must not be interrupted by pressing BREAK or DEL. 
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Name 


sleep — Suspends execution for an interval. 


Syntax 


sleep time 


Description 


Sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time as in: 


(sleep 105; command) & 


or to execute a command every so often, as in: 


while true 
do 
command 
sleep 37 
done 


See Also “es 


alarm(S), sleep(S) 


Notes 


Time must be less than 65536 seconds. 
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Name 


sort — Sorts and merges files. 


Syntax 


sort [| — cmubdfinrtx ] [ +posl [ — pos2 }] ] ... [ — o output] 
[ files | 


Descnption 


Sort merges and sorts lines from all named files and writes the result 
on the standard output. A dash (— ) may appear as a file in the files 
argument signifying the standard input. If no input files are named, 
the standard input is sorted. 


The default sort key is an entire line. Default ordering is lexico- 
graphic by bytes in machine collating sequence. The ordering is 
affected globally by the following options, one or more of which may 
appear. 


—b Ignores leading blanks (spaces and tabs) in field comparisons. 


—d ‘‘Dictionary’’ order: only letters, digits and blanks are 
significant In comparisons. 


—f Folds uppercase letters onto lowercase. 


— i Ignores characters outside the ASCII octal range 040-0176 in 
nonnumeric comparisons. 


—n An initial numeric string, consisting of optional blanks, 
optional minus sign, and zero or more digits with optional 
decimal point, is sorted by arithmetic value. Option n implies 
option b. 


—r Reverses the sense of comparisons. 
— tz ‘‘Tab character’’ separating fields is z. 


The notation + pos! — pos? restricts a sort key to a field beginning 
at posi and ending just before poe2. Poel and pos? each have the 
form m.n, optionally followed by one or more of the flags bdfinr, 
) where m tells a number of fields to skip from the beginning of the 
Y line and n tells a number of characters to skip further. If any flags 
are present they override all the global ordering options for this key. 
If the b option is in effect n is counted from the first nonblank in 
the field; b is attached independently to pos2. A missing .n means 
.0; a missing — pos? means the end of the line. Under the — tz 
option, fields are strings separated by 2; otherwise fields are 
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nonempty nonblank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only 
after all earlier keys compare equal. Lines that otherwise compare 
equal are ordered with all bytes significant. Very long lines are 
silently truncated. 


These option arguments are also understood: 


—c Checks that the input file is sorted according to the ordering 
rules; gives no output unless the file is out of sort. 


—m Merges only, the input files are already sorted. 

—u_ Suppresses all but one in each set of duplicated lines. Ignored 
bytes and bytes outside keys do not participate in this com- 
parison. 

—o The next argument is the name of an output file to use instead 
of the standard output. This file may be the same as one of 
the inputs. 

Examples 


The following prints in alphabetical order all the unique spellings in a 
list of words (capitalized words differ from uncapitalized): 


sort —- u + Of +0 list 


The following prints the password file ( passwd(M)) sorted by user ID 
(the third colon-separated field): 


sort — t: +2n /etc/passwd 
The following prints the first instance of each month in an already 
sorted file of (month-day) entries (the options — um with just one 
input file make the choice of a unique representative from a set of 


equal lines predictable): 


sort — um +090 —- 1 dates 


Files 


/usr/tmp/stm??? 
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See Also 


comm{C), join(C}, uniq(C) 


\& Diagnostics 
Comments and exits with nonzero status for various trouble condi- 


tions and for disorder discovered under option — c. 


9 
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Name 


split — Splits a file into pieces. 


Syntax 


split [ — n] [ file [ name | | 


Description 


Split reads file and writes it in n-line pieces (default 1000), as many 
as necessary, onto a set of output files. The name of the first output 
file is name with aa appended, and so on lexicographically. If no 
output name is given, x is default. 


If no input file is given, or if a dash (— ) is given instead, then the 
standard input file is used. 
See Also 


bfs(C), csplit(C) 
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Name 


stty — Sets the options for a terminal. 


Syntax 


stty [— a] [ — g] [ options | 


Description 


Stty sets certain terminal I/O options for the device that is the 
current standard input; without arguments, it reports the settings of 
certain options; with the — a option, it reports all of the option set- 
tings; with the — g option, it reports current settings in a form that 
can be used as an argument to another etty command. Detailed 
information about the modes listed in the first five groups below 
may be found in tty(M). Options in the last group are implemented 
using options in the previous groups. The options are selected from 
the following: 


Control Modes 


parenb (— parenb) 
Enables (disables) parity generation and detection. 


parodd (— parodd) 
Selects odd (even) parity. 


cs5 cs6 cs7 cs8 
Selects character size (see tty(M)). 


QO Hangs up phone line immediately. 
50 75 110 134 150 200 300 600 


1200 1800 2400 4800 9600 exta 
Sets terminal baud rate to the number given, if possible. 


hupcl (— hupcl) 
Hangs up (does not hang up) phone connection on last close. 


hup (— hup) 
Same as hupcl (— hupcl). 


wy cstopb (— cstopb) 
Uses two(one) stop bits per character. 


cread (— cread) 


Enables (disables) the receiver. 
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clocal (— clocal) 
Assumes a line without (with) modem control. 


Input Modes 


ignbrk (— ignbrk) 


Ignores (does not ignore) break on input. 


brkint (— brkint) 
Signals {does not signal) INTR on break. 


ignpar (— ignpar) 
Ignores (does not ignore) parity errors. 


parmrk (— parmrk) 
Marks (does not mark) parity errors (see tty(M)). 


inpck (— inpck) 
Enables (disables) input parity checking. 


istrip (— istrip) 
Strips (does not strip) input characters to 7 bits. 


inlcr (— inlcr) 


Maps (does not map) NL to CR on input. “A 
igncr (— igncr) 


Ignores (does not ignore) CR on input. 


icrnl (— icrnl) 
Maps (does not map) CR to NL on input. 


iucle (— iuclc) 
Maps (does not map) uppercase alphabetics to lowercase on 
input. 


ixon (— ixon) 
Enables (disables) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by sending an 
ASCII DC1. 


ixany (— ixany) 
Allows any character (only DC1) to restart output. 


ixoff (— ixoff) 
Requests that the system send (not send) START/STOP charac- 
ters when the input queue is nearly empty/full. 
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Output Modes 


opost (— opost) 
Post- processes output (does not post-process output; ignores al] 
other output modes). 


\Y olcuc (— olcuc) 
Maps (does not map) lowercase alphabetics to uppercase on out 


put. 


onlcr (— onlcr) 
Maps (does not map) NL to CR-NL on output. 


ocrnl (— ocrnl) 
Maps (does not map) CR to NL on output. 


onocr (— onocr) 
Does not (does) output CRs at column zero. 


onlret (— onlret) 
On the terminal NL performs (does not perform) the CR func- 
tion. 


ofill (— ofill) 
Uses fill characters (use timing) for delays. 


ofdel (— ofdel) 
Fill characters are DELs (NULs). 


crO crl cr2 cr3 
Selects style of delay for carriage returns (see tty(M)). 


nlO nll 
Selects style of delay for linefeeds (see tty(M)). 


tabO tabl tab2 tab3 
Selects style of delay for horizontal tabs (see tty(M)). 


bsO bs1 
Selects style of delay for backspaces (see tty(M)). 


ffO ffl 
Selects style of delay for form feeds (see tty(M)). 


vtO0 vtl 


9 Selects style of delay for vertical tabs (see tty(M)). 
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isig (— isig) 
Enables (disables) the checking of characters against the special 
control characters INTR and QUIT. 


icanon (— icanon) 
Enables (disables) canonical input (ERASE and KILL process- 
ing). 


xcase (— xcase) 
Canonical (unprocessed) upper/lowercase presentation. 


echo (— echo) 
Echoes back (does not echo back) every character typed. 


echoe (— echoe) 
Echoes (does not echo) ERASE character as a backspace-space- 
backspace string. Note: this mode will erase the ERASEed char- 
acter on many CRT terminals; however, it does not keep track of 
column position and, as a result, may be confusing on escaped 
characters, tabs, and backspaces. 


echok (— echok) 
Echoes (does not echo) NL after KILL character. 


Ifke (— Ifkc) 
The same as echok (- echok); obsolete. 


echonl (— echonl) 
Echoes (does not echo) NL. 


noflsh (— noflsh) 
Disables (enables) flush after INTR or QUIT. 


Control Assignments 


control-character-C 
Sets control-character to C, where control-character is erase, kill, 
intr, quit, eof, eol, If C is preceded by a caret (*) (escaped from 
the shell), then the value used is the corresponding CNTRL 
character (e.g., ‘‘“D’’ is a CNTRL-D ); ‘‘*?”’ is interpreted as 
DEL and ‘‘~— ”’ is interpreted as undefined. 


min 1, time 1 (0<1<127) 
When — icanon is not set, read requests are not satisfied until at 
least min characters have been received or the timeout value 
time has expired. See tty(C). 


line + 
Sets the line discipline to + (0 < + < 127 ). There are currently 
no line disciplines implemented. 
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Combination Modes 


evenp or parity 
Enables parenb and cs7. 


oddp 
Enables parenb, cs7, and parodd. 


— parity, — evenp, or — oddp 
Disables parenb, and sets cs8. 


raw (— raw or cooked) 
Enables (disables) raw input and output (no ERASE, KILL, 
INTR, QUIT, EOT, or output post processing). 


nl (— nl) 
Unsets (sets) icrnl, onlcr. In addition — nl unsets inlcr, igncr, 
ocrnl, and onlret. 


Icase (— Icase) 
Sets (unsets) xcase, iuclc, and olcuc. 


LCASE (— LCASE) 
Same as Icase (— lIcase). 


tabs (— tabs or tab3) 


Preserves (expands to spaces) tabs when printing. 


ek Resets ERASE and KILL characters back to normal CNTRL-H and 
CNTRL-U . 


sane 
Resets all modes to some reasonable values. Useful when a 
terminal’s settings have been hopelessly scrambled. 


term 
Sets all modes suitable for the terminal type term, where term is 
one of tty33, tty37, vt05, tn300, ti700, or tek. 
See Also 


ioctl(S), tty(M) 


F Notes 
Many combinations of options make no sense, but no checking is 


performed. 
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Name 


su — Makes the user super-user or another user. 


Syntax 


su[— | [ name [| arg... | ] 


Description 


Su allows you to become another user without logging off. The 
default user name is root (i.e., super-user). 


To use seu, the appropriate password must be supplied (unless you 
are already super-user). If the password is correct, su executes a 
new shell with the user ID set to that of the specified user. To 
restore normal user ID privileges, type a CNTRL-D to the new shell. 


Any additional arguments are passed to the shell, permitting the 
super-user to run shell procedures with restricted privileges (an arg 
of the form — c string executes string via the shell). When additional 
arguments are passed, /bin/sh is always used. When no additional 
arguments are passed, su uses the shell specified in the password file. 


An initial dash (— ) causes the environment to be changed to the 
one that would be expected if the user actually logged in again. This 
is done by invoking the shell with an arg0 of — su causing the 
.profile in the home directory of the new user ID to be executed. 
Otherwise, the environment is passed along with the possible excep- 
tion of $PATH , which is set to /bin:/etc:/usr/bin for root. Note 
that .profile can check argO for — sh or — su to determine how it 
was invoked. 


Files 
/etc/passwd The system password file 
$HOME/.profile User’s profile 

See Also 


env(C), login(M), sh(C), environ(M) 
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Name 

sum — Calculates checksum and counts blocks in a file. 
Syntax 

sum [ — r] file 
Description 


Sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of blocks in the file. It is typically used to 
look for bad spots, or to validate a file communicated over a 
transmission line. The option — r causes an alternate algorithm to 
be used in computing the checksum. 


See Also 
we(C) 
Diagnostics 
&Y ‘‘Read error’’ is indistinguishable from end-of-file on most devices; 
check the block count. 
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Name 


sync — Updates the super-block. 


Syntax 


sync ry 


Description 


Syne executes the sync system primitive. If the system is to be 
stopped, sync must be called to ensure file system integrity. Note 
that shutdown(C) automatically calls syne before shutting down the 
system. 


See Also 


sync(S) 
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Name 


sysadmin — Performs file system backups and restores files. 


Syntax 


/etc/sysadmin 


Description 


Sysadmin is a script for performing file system backups and for res- 
toring files from backup disks. It can do a daily incremental backup 
(level 9), or a periodic full backup (level 0). It can provide a listing 
of the files backed up and also has a facility to restore individual files 
from a backup. 


Sysadmin operates on XENIX format diskettes. The version provided 
backs up the root file system. The script can be edited to operate on 
additional file systems if required. 


You must be the super-user to use this program. 


Y Files 
/tmp/backup.list 


See Also 


dump(C), restor(C), mkfs(C), dumpdir(C) 


& 
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Name 


tail— Delivers the last part of a file. 


Syntax 


tail [ + [number] [Ibc] [ — f] ] [ file ] 


Description 


Tail copies the named file to the standard output beginning at a 
designated place. If no file is named, the standard input is used. 


Copying begins at distance -++-number from the beginning, or 
— number from the end of the input (if number is null, the value 10 
is assumed). Number is counted in units of lines, blocks, or charac- 
ters, according to the appended option I, b, orc. When no units are 
specified, counting is by lines. 


With the — f (‘‘follow’’) option, if the input file is not a pipe, the 
program will not terminate after the line of the input file has been 
copied, but will enter an endless loop, wherein it sleeps for a second 
and then attempts to read and copy further records from the input 
file. Thus it may be used to monitor the growth of a file that is 
being written by some other process. For example, the command: 


tail — f file 
will print the last ten lines of file, followed by any lines that are 
appended to file between the time tai is initiated and killed. 
See Also 


dd(C) 


Notes 


Tails relative to the end of the file are kept in a buffer, and thus are 
limited in length. Unpredictable results can occur if character special 
files are ‘‘tailed’’. 
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Name 


tar — Archives files. 


Syntax 


tar [ key | [ files ] 


Description 


Tar saves and restores files to and from an archive medium, which 
is typically a storage device such as floppy disk or tape, or a regular 
file. Its actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter and possi- 
bly one or more function modifiers. Valid function letters are c, t, 
x, u, andr. Other arguments to the command are files (or directory 
names) specifying which files are to be backed up or restored. In all 
cases, appearance of a directory name refers to the files and (recur- 
sively) subdirectories of that directory. 


The function portion of the key is specified by one of the following 
letters: 


r The named files are written to the end of the archive. The 
c function implies this function. 


x The named files are extracted from the archive. If a named 
file matches a directory whose contents had been written 
onto the archive, this directory is (recursively) extracted. 
The owner, modification time, and mode are restored (if 
possible). If no files argument is given, the entire contents 
of the archive are extracted. Note that if several files with 
the same name are on the archive, the last one overwrites 
all earlier ones. 


t The names of the specified files are listed each time that 
they occur on the archive. If no files argument is given, all 
the names on the archive are listed. 


u The named files are added to the archive if they are not 
already there, or if they have been modified since last writ- 
ten on that archive. 


i Cc Creates a new archive; writing begins at the beginning of 
& the archive, instead of after the last file. This command 
implies the r function. 

e Prevents files from being split across volumes (tapes or 
floppy disks). If there is not enough room on the present 
volume for a given file, tar prompts for a new volume. 
This is only valid when the -k option is also specified on the 
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command line. 


The following characters may be used in addition to the letter that 
selects the desired function: 


0,...,7 This modifier selects the drive on which the archive is 
mounted. The default is 1. 


Vv Normally, tar does its work silently. The v (verbose) 
option causes it to type the name of each file it treats, pre- 
ceded by the function letter. With the t function, v gives 
more information about the archive entries than just the 
name. 


w Causes tar to print the action to be taken, followed by the 
name of the file, and then wait for the user’s confirmation. 
If a word beginning with y is given, the action is performed. 
Any other input means ‘‘no’’. 


f Causes tar to use the next argument as the name of the 
archive instead of /dev/mt?. If the name of the file is a 
dash (— ), tar writes to the standard output or reads from 
the standard input, whichever is appropriate. Thus, tar can 
be used as the head or tail of a pipeline. Tar can also be 
used to move hierarchies with the command: 


cd fromdir; tar cf — .|(cd todir; tar xf — ) “ 


b Causes tar to use the next argument as the blocking factor 
for archive records. The default is 1, the maximum is 20. 
This option should only be used with raw magnetic tape 
archives (see f above). The block size is determined 
automatically when reading tapes (key letters x and t). 


F Causes tar to use the next argument as the name of a file 
from which succeeding arguments are taken. A lone dash 
(— ) signifies that arguments will be taken from the stan- 
dard input. 


] Tells tar to print an error message if it cannot resolve all of 
the links to the files being backed up. If 1 is not specified, 
no error messages are printed. 


m Tells tar to not restore the modification times. The 
modification time of the file will be the time of extraction. 


k Causes tar to use the next argument as the size of an 
archive volume in kilobytes. The minimum value allowed 
is 250. This option is useful when the archive is not 
intended for a magnetic tape device, but for some fixed size 
device, such as floppy disk (See f above). Very large files 
are split into ‘‘extents’’ across volumes. When restoring 
from a multivolume archive, tar only prompts for a new 
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volume if a split file has been partially restored. 


n Indicates the archive device is not a magnetic tape. The k 
option implies this. Listing and extracting the contents of an 
archive are sped because tar can seek over files it wishes to 
skip. Sizes are printed in kilobytes instead of tape blocks. 


p Indicates that files are extracted using their original permis- 
sions. It is possible that a non-super-user may be unable to 
extract files because of the permissions associated with the 
files or directories being extracted. 


Examples 


If the name of a floppy disk device is /dev/fdl, then a tar format file 
can be created on this device by typing: 


assign /dev/fd 
tar cvfk /dev/fdl 360 files 


where files are the names of files you want archived and 360 is the 
capacity of the floppy disk in kilobytes. Note that arguments to key 
letters are given in the same order as the key letters themselves, 
thus the fk key letters have corresponding arguments /dev/fdl and 
360. Note that if a file is a directory then the contents of the direc- 
tory are recursively archived. To print a listing of the archive, type: 


tar tvf /dev/fdl 


At some later time you will likely want to extract the files from the 
archive floppy. You can do this by typing: 


tar xvf /dev/fdl 


The above command extracts all files from the archive using the 
exact same pathnames as used when the archive was created. 
Because of this behavior, it is normally best to save archive files with 
relative pathnames rather than absolute ones, since directory permis- 
sions may not let you read the files into the absolute directories 
specified. 


In the above examples, the v verbose option is used simply to 
confirm the reading or writing of archive files on the screen. Also, a 
normal file could be substituted for the floppy device /dev/fdl in the 


YY examples. 
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Files 
/etc/default/dump Default devices 


/tmp/tar* 


Diagnostics 


Prints an error message about bad key characters and archive 
read/write errors. 


Prints an error message if not enough memory is available to hold 
the link tables. 


Notes 
There is no way to ask for the nth occurrence of a file. 
The u option can be slow. 


The b option should not be used with archives that are going to be 
updated. If the archive is on a disk file, the b option should not be 
used at all, because updating an archive stored on disk can destroy it. 
In order to update (r or u option) a tar archive, do not use raw 
magtape and do not use the boption. This applies both when updat- 
ing and when the archive was first created. 


The limit on filename length is 100 characters. 


When archiving a directory that contains subdirectories, tar will only 
access those subdirectories that are within 17 levels of nesting. Sub- 
directories at higher levels will be ignored after tar displays an error 
message. 


Systems with a 1K-byte file system cannot specify raw disk devices 
unless the b option is used to specify an even number of blocks. 
This means that one cannot update a raw-mode disk partition. used. 
Don’t do: 


tar xt = 


This would imply taking two things from the standard input at the 
same time. 
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Name 


tee — Creates a tee in a pipe. 


Syntax 


tee {—i][-a] | file ] ... 


Description 
Tee transcribes the standard input to the standard output and makes 
copies in the files. The — i option ignores interrupts; the — a option 
causes the output to be appended to the fles rather than overwriting 
them. 

Examples 


The following example illustrates the creation of temporary files at 
each stage in a pipeline: 


grep ABC |tee ABC.grep |sort | tee ABC.sort |more 
This example shows how to tee output to the terminal screen: 


grep ABC |tee /dev/tty |sort |uniq >final.file 
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Name 


test — Tests conditions. 


Syntax 


test expr ry 


[ expr ] 


Description 


Test evaluates the expression ezpr and, if its value is true, returns a 
zero (true) exit status; otherwise, a test returns a nonzero exit status 
if there are no arguments. The following primitives are used to con- 
struct ezpr: 


—r file True if file exists and is readable. 

— w file True if file exists and is writable. 

— x file True if file exists and is executable. 

— f file True if file exists and is a regular file. 

— d file True if file exists and is a directory. a) 
— c file True if file exists and is a character special file. 

— bfile True if file exists and is a block special file. 

— u file True if file exists and its set-user-ID bit is set. 

— g file True if file exists and its set-group-ID bit is set. 

— k file True if file exists and its sticky bit is set. 

— s file True if file exists and has a size greater than zero. 


t [ fildes| True if the open file whose file descriptor number is 
fildes (1 by default) is associated with a terminal device. 


— 2 él True if the length of string sf is zero. 

—nel True if the length of the string s/ is nonzero. ry 
si == se? True if strings s/ and s2 are identical. 

s1 {== e2 True if strings s/ and s2 are not identical. 
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81 True if sf is not the null string. 
nl —eqn2 True if the integers ni and n2 are algebraically equal. 
Any of the comparisons — ne, — gt, — ge, — It, and — le 


may be used in place of — eq. 


These primaries may be combined with the following operators: 


! Unary negation operator 

—a Binary and operator 

— oO Binary or operator (— a has higher precedence than 
aS o) 

( expr ) Parentheses for grouping 


Notice that all the operators and flags are separate arguments to test. 
Notice also that parentheses are meaningful to the shell and, there- 
fore, must be escaped. 


See Also 


find(C), sh(C) 


Warning 


In the second form of the command (i.e., the one that uses [], 
rather than the word test), the square brackets must be delimited by 
blanks. 
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Name 


touch — Updates access and modification times of a file. 


Syntax 


touch [ — amc] [| mmddhhmm|[yy] ] files ry 


Description 


Touch causes the access and modification times of each argument to 
be updated. If no time is specified (see date(C)) the current time is 
used. The — a and — m options cause touch to update only the 
access or modification times respectively (default is - am). The — c 
option silently prevents touch from creating the file if it did not pre- 
viously exist. 


The return code from touch is the number of files for which the 
times could not be successfully modified (including files that did not 
exist and were not created). 


See Also 


date(C), utime(S) 
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tr — Translates characters. 


Syntax 


tr [| — cds ] [ string1 [ string2 | | 


Description 


Tr copies the standard input to the standard output with substitution 
or deletion of selected characters. Input characters found in stnng1 
are mapped into the corresponding characters of string2. Any combi- 
nation of the options — cds may be used: 


—C Complements the set of characters in string with respect to 
the universe of characters whose ASCII codes are 001 
through 377 octal 

—d Deletes all input characters in string! 


—s Squeezes all strings of repeated output characters that are in 
string? to single characters 


The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 


[a- z] Stands for the string of characters whose ASCII codes run 
from character a to character z, inclusive. 


[a*n] Stands for n repetitions of a. If the first digit of n is 0, n is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding stnng2. 


The escape character \ may be used as in the shell to remove special 
meaning from any character in astring. In addition, \ followed by 1, 
2, or 3 octal digits stands for the character whose ASCII code is given 
by those digits. 


The following example creates a list of all the words in filef one per 

line in file2, where a word is taken to be a maximal string of alpha- 

betics. The strings are quoted to protect the special characters from 
YY interpretation by the shell; 012 is the ASCII code for newline: 


tr — cs "[A- Z][a- z]” "[\012*]” <filel >file2 
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See Also 


ed(C), sh(C), ascii(M) 


Notes 


Won’t handle ASCII NUL in stringi or strnng?2; always deletes NUL ry 


from input. 
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Name 


true — Returns with a zero exit value. 


Syntax 


true 


Description 


True does nothing except return with a zero exit value. False(C), 
true’s counterpart does nothing except return with a nonzero exit 
value. True is typically used in shell procedures such as: 


while true 
do 

command 
done 


See Also 


sh(C), false (C) 


YU Diagnostics 


True has exit status zero. 


YY 
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Name 


tset — Sets terminal modes. 


Syntax O™ 
tset[ — ] [ — hrsIQS ] [ - e[e] ] [- Eld ] [- kl] 


[ — m [tdent]| test baudrate]:type | [ type | 


Description 


Tset causes terminal dependent processing such as setting erase and 
kill characters, setting or resetting delays, and the like. It is driven 
by the /etc/ttytype and /etc/termcap files. 


The type of terminal is specified by the type argument. The type 
may be any type given in /etc/termcap. If type is not specified, the 
terminal type is the value of the environment variable TERM, unless 
the — h flag is set or any — m argument is given. In this case the 
type is read from /etc/ttytype (the port name to terminal type data- 
base). The port name is determined by a ttyname(S) call on the 
diagnostic output. If the port is not found in /etc/ttytype the termi- 
nal type is set to unknown. 


Ports for which the terminal type is indeterminate are identified in 
/etc/ttytype as dialup, plugboard, etc. The user can specify how 
these identifiers should map to an actual terminal type. The map- 
ping flag, — m, is followed by the appropriate identifier (a four- 
character or longer substring is adequate), an optional test for baud 
rate, and the terminal type to be used if the mapping conditions are 
satisfied. Note that this type is not the same as the explicitly given 
type. If more than one mapping is specified, the first correct map- 
ping prevails. A missing identifier matches all identifiers. Baud 
rates are specified as with stty(C), and are compared with the speed 
of the diagnostic output. The test may be any combination of: >, 
=, <, @, and !. (Note: @ is a synonym for = and ! inverts the 
sense of the test. Remember to escape characters meaningful to the 


shell.) 


If the type as determined above begins with a question mark, the 
user is asked if he really wants that type. A null response means to 
use that type; otherwise, another type can be entered which will be 
used instead. (The question mark must be escaped to prevent 
filename expansion by the shell.) The — e flag sets the erase charac- 
ter to be the named character ¢ on all terminals, so to override this 
option one can say — e#. The default for ¢ is the backspace charac- 
ter on the terminal, usually CNTRL-H . The — E flag is identical to 
—e except that it only operates on terminals that can backspace. 
The — k option works similarly, with ¢ defaulting to CNTRL-U. No 
kill processing is done if — k is not specified. In all of these flags, 
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‘«“X’’ where X is any character is equivalent to CNTRL-X . 


The — option prints the terminal type on the standard output; this 
can be used to get the terminal type by saying: 


set termtype = ‘tset -° 


ww If no other options are given, tset operates in ‘‘fast mode’’ and only 
outputs the terminal type, bypassing all other processing. The — s 
option outputs ‘‘setenv’’ commands (if your default shell is csh( CP) 
or ‘‘export’’ and assignment commands (if your default shell is 
eh(CP)); the — S option only outputs the strings to be placed in the 
environment variables. For the — s option with the Bourne shell, 
use: 


‘tset-s ... 


tset-s ... > /tmp/tset$$ 
/tmp/tset$$ 
rm /tmp/tset$$ 


If you are using csh, use: 


set noglob 

set term=(‘tset -S ....‘) 
setenv TERM $term[1] 
setenv TERMCAP "$term[2]” 
unset term 

unset noglob 


The — r option prints the terminal type on the diagnostic output. 
The — Q option suppresses printing the ‘‘Erase set to’’ and ‘‘Kill set 
to’’ messages. The — I option suppresses outputing the terminal ini- 
tialization strings. 


Tset is most useful when included in the -login (for csh(CP)) or 
.profile (for sh(C)) file executed automatically at login, with — m 
mapping used to specify the terminal type you most frequently dial 
in on. 
Ex amples 
; tset gt42 
vw tset — mdialup\>300:adm3a — mdialup:dw2 —- Qr- e# 


tset — m dial:ti733 — m plug:\? hp2621 — m unknown:\? - e — k*U 


June 8, 1984 Page 2 


TSET (C) TSET(C) 


Files 


/etc/ttytype Port name to terminal type map database 


Jetc/termcap Terminal capability database 


See Also 


tty(M), termcap(M), stty(C) 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 
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Name 


tty — Gets the terminal’s name. 


Syntax 


tty[-s] 


Description 
The tty command prints the pathname of the user’s terminal on the 
standard output. The — s option inhibits printing, allowing you to 
test just the exit code. 

Exit Codes 


0 if the standard input is a terminal, 1 otherwise. 
Diagnostics 


not a tty If the standard input is not a terminal and — s is not 
specified 
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Name 


umask — Sets file-creation mode mask. 


Syntax 


umask [ 000 | 


Description 


See 


The user file-creation mode mask is set to ooo. The three octal 
digits refer to read/write/execute permissions for owner, group, and 
others, respectively Only the low-order 9 bits of cmask and the file 
mode creation mask are used. The value of each specified digit is 
‘‘subtracted’’ from the corresponding ‘‘digit’’ specified by the system 
for the creation of any file (see umask(S) or creat(S)). This is actu- 
ally a binary masking operation, and thus the name ‘‘umask’’. In 
general, binary ones remove a given permission and zeros have no 
effect at all. For example, umask 022 removes group and others 
write permission (files normally created with mode 777 become 
mode 755 ; files created with mode 666 become mode 644). 


If ooo is omitted, the current value of the mask is printed. 

Umaek is recognized and executed by the shell. By default, login 
shells have a umask of 022. 

Also 


chmod({C), sh(C), chmod(S), creat(S), umask(S) 
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Name 


umount — Dismounts a file structure. 


Syntax 


/etc/umount special- device 


Description 


Umount announces to the system that the removable file structure 
previously mounted on device special-device is to be removed. Any 
pending I/O for the file system is completed, and the file structure is 
flagged clean. For fuller explanation of the mounting process see 


mount(C). 


Files 


/etc/mnttab Mount table 


See Also 


mount(C), mount(S), mnttab(F) 


Diagnostics 


device busy An executing process is using a file on the named 
file system 
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Name 


uname — Prints the current XENIX name. 


Syntax 


uname [ — snrmduva | ry 


Description 


Uname prints the current system name of XENIX on the standard 
output file. The options cause selected information returned by 
uname(S) to be printed: 


s Prints the system name (default) 


n Prints the nodename (the nodename may be a name that the 
system is known by to a communications network) 


r Prints the operating system release 


—m 
Manufacturer Prints original supplier of XENIX system 


-d_ Distributor Prints OEM for this system " 


— u Prints user serial number for this system 


— v Prints the operating system version 


— a Prints all the above information 


See Also 


uname(S) 
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Name 


uniq — Reports repeated lines in a file. 


Syntax 


uniq [ — ude [ +n] [-—n] ] [ input [ output | | 


Description 


See 


Untg reads the input file and compares adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are 
removed; the remainder is written on the output file. /nput and -out- 
put should always be different. Note that repeated lines must be 
adjacent in order to be found; see sort(C). If the — u flag is used, 
just the lines that are not repeated in the original file are output. 
The — d option specifies that one copy of just the repeated lines is to 
be written. The normal mode output is the union of the — u and 
— dmode outputs. 


The — c option supersedes — u and —d and generates an output 
report in default style but with each line preceded by a count of the 
number of times it occurred. 


The n arguments specify skipping an initial portion of each line in 
the comparison: 


—n The first n fields together with any blanks before each are 
ignored. A field is defined as a string of nonspace, nontab 


characters separated by tabs and spaces from its neighbors. 


+n The first n characters are ignored. Fields are skipped before 
characters. 


Also 


comm((C), sort{(C) 
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Name 


units — Converts units. 


Syntax 


units try 


Description 


Units converts quantities expressed in various standard scales to 
their equivalents in other scales. It works interactively in this 
fashion: 


You have: inch 

You want: cm 
* 2.540000e+ 00 
/ 3.937008e- 01 


A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated by 
suffixed positive integers, division by the usual sign: 


You have: 15 Ibs force/in2 
You want: atm 
* 1.020689e+ 00 


/ 9.797299e- 01 


Units only does multiplicative scale changes; thus it can convert Kel- 
vin to Rankine, but not Centigrade to Fahrenheit. Most familiar 
units, abbreviations, and metric prefixes are recognized, as well as 
the following: 


pi Ratio of circumference to diameter 
Cc Speed of light 

e Charge on an electron 

g Acceleration of gravity 


force Same asg 


mole Avogadro’s number 


water Pressure head per unit height of water 


au Astronomical unit 
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Pound is not recognized as a unit of mass; Ibis. Compound names 


are run together, (e.g. lightyear). British units that differ from 
their US counterparts are prefixed with ‘‘br’’. For a complete list of 
units, type: 


vy cat /usr/lib/unittab 


Files 


/usr/lib/unittab 


_— 
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Name 


vi— Invokes ascreen-oriented display editor. 


Syntax 


vi [ — option... ] [ command | [ filename] 


Description 


Vi offers a powerful set of text editing operations based on a set of 
mnemonic commands. Most commands are single keystrokes that 
perform simple editing functions. Vi displays a full screen ‘‘win- 
dow’’ into the file you are editing. The contents of this window can 
be changed quickly and easily within vi. While editing, visual feed- 
back is provided (the name vi itself is short for ‘‘visual’’ ). 


Vi and the line editor ex are one and the same editor: the names vi 

and ex identify a particular user interface rather than any underlying 
functional difference. The differences in user interface, however, 

are quite striking. Ex is a powerful line-oriented editor, similar to the 

editor ed. However, in both ex and ed, visual updating of the termi- 

nal screen is limited, and commands are entered on a command line. 

Vi, on the other hand, is a screen-oriented editor designed so that nr 
what you see on the screen corresponds exactly and immediately to 

the contents of the file you are editing. 


Options available on the vi command line: 


— t Equivalent to an initial tag command; edits the file con- 
taining the tag and positions the editor at its definition. 


a Used in recovering after an editor or system crash, 
retrieving the last saved version of the named file. If no 
file is specified, this option prints a list of saved files. 


- | Specific to editing LISP, this option sets the showmatch 
and lisp options. 


— wn Sets the default window size to n. Useful on dialups to 
start in small windows. 


—- x Causes vi to prompt for a key used to encrypt and decrypt 
the contents of the named files. 

-R Sets a readonly option so that files can be viewed but not 
edited. 
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The Editing Buffer 


Vi performs no editing operations on the file that you name during 
invocation. Instead, it works on a copy of the file in an editing buffer. 
The editor remembers the name of the file specified at invocation, so 
that it can later copy the editing buffer back to the named file. The 
VY contents of the named file are not affected until the changes are 
copied back to the original file. This allows editing of the buffer 
without immediately destroying the contents of the original file. 


When you invoke vi with a single filename argument, the named file 
is copied to a temporary editing buffer. When the file is written out, 
the temporary file is written back to the named file. 


Modes of Operation 


Within vi there are three distinct modes of operation: 


Command Mode Within command mode, signals from the 
keyboard are interpreted as editing com- 
mands. 

Insert Mode Insert mode can be entered by typing any 


of the vi insert, append, open, substitute, 
change, or replace commands. Once in 
insert mode, letters typed at the keyboard 
are inserted into the editing buffer. 


Ex Escape Mode The vi and ex editors are one and the 
same editor differing mainly in their user 
interface. In vi commands are usually sin- 
gle keystrokes. In ex, commands are lines 
of text terminated by aRETURN. Vi has a 
special ‘‘escape’’ command that gives 
access to many of these line-oriented ex 
commands. To escape to ex escape mode, 
type a colon (:). The colon is echoed on 
the status line as a prompt for the ex 
command. An executing command can 
be aborted by pressing INTERRUPT. Most 
file manipulation commands are executed 
in ex escape mode; for example, the com- 
mands to read in a file, and to write out 
the editing buffer to a file. 


wy Special Keys 


There are several special keys in vi. These keys are used to edit, del- 
imit, or abort commands and command lines. 
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ESC Used to return to vi command mode, cancel partially 
formed commands. 


RETURN 
Terminates ex commands when in ex escape mode. Also 
used to start a new line when in insert mode. 


INTERRUPT 
Often the same as the DEL or RUBOUT key on many termi- 
nals. Generates an interrupt, telling the editor to stop what 
it is doing. Used to abort any command that is executing. 


/ Used to specify a string to be searched for. The slash 
appears on the status line as a prompt for a search string. 
The question mark (?) works exactly like the slash key, 
except that it is used to search backward in a file instead of 
forward. 


The colon is a prompt for an ex command. You can then 
type in any ex command, followed by an ESC or RETURN 
and the given ex command is executed. 


The following characters are special in insert mode: 


BKSP Backs up the cursor one character on the current line. 
The last character typed before the BKSP is removed from 
the input buffer, but remains displayed on the screen. 


CNTRL-U Moves the cursor back to the first character of the inser- 
tion, and restarts insertion. 


CNTRL-V Removes the special significance of the next typed charac- 
ter. Use CNTRL-V to insert control characters. Line feed 
and CNTRL-J cannot be inserted in the text except as 
newline characters. CNTRL-Q and CNTRL-S are trapped 
by the operating system before they are interpreted by vi, 
so they too cannot be inserted as text. 


CNTRL-W Moves the cursor back to the first character of the last 
inserted word. 


CNTRL-T During an insertion, with the autoindent option set and at 
the beginning of the current line, typing this character 
will insert shiftwidth whitespace. 


CNTRL-@ If typed as the first character of an insertion it is replaced 
with the last text inserted, and the insertion terminates. 
Only 128 characters are saved from the last insertion. If 
more than 128 characters were inserted, then this com- 
mand inserts no characters. A CNTRL-@ cannot be part 
of a file, even if quoted. 
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Invoking and Exiting Vi 


To enter vi type: 


vl Edits empty editing buffer 
& vi file Edits named file 

vi + 123 file Goes to line 123 

vi + 45 file Goes to line 45 

vi + /word file Finds first occurrence of ‘“‘word’’ 

vi + /tty file Finds first occurrence of “‘tty’”’ 


There are several ways to exit the editor: 


ZZ The editing buffer is written to the file only if any changes were 
made. 


x The editing buffer is written to the file only if any changes were 


made. 

:q! Cancels an editing session. The exclamation mark (!) tells vi 
to quit unconditionally. In this case, the editing buffer is not 
written out. 


Vi Commands 


Vi is a visual editor with a window on the file. What you see on the 
screen is vi’s notion of what the file contains. Commands do not 
cause any change to the screen until the complete command is typed. 
Most commands may take a preceding count that specifies repetition 
of the command. This count parameter is not given in the following 
command descriptions, but is implied unless overriden by some 
other prefix argument. When vi gets an improperly formatted com- 
mand it rings a bell. 


Cursor Movement 


The cursor movement keys allow you to move your cursor around in 
a file. Note in particular the arrow keys (if available on your termi- 
’ nal); the “th’'“‘y"', ‘‘k” | spot cursor keys; and SPACE, BKSP. 
CNTRL-N, and CNTRL-P. These three sets of keys perform identical 


functions. 


Forward Space — I, SPACE, or --> 


Syntax: ] 
SPACE 
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--> 


Function: Moves the cursor forward one character. If a count is 
given, move forward count characters. You cannot move 
past the end of the line. 


Backs pace — h, BKSP, or <-- 


Syntax: h 
BKSP 
gee 


Function: Moves cursor backward one character. If a count is 
given, moves backward count characters. Note that you 
cannot move past the beginning of the current line. 


Next Line — +, RETURN, j, CNTRL-N, and LF 


Syntax: oe 
RETURN 


Function: Moves the cursor down to the beginning of the next line. 


Syntax: j 
CNTRL-N 


LF 
(down arrow) 


Function: Moves the cursor down one line, remaining in the same 
column. Note the difference between these commands 
and the preceding set of next line commands which move 
to the beginning of the next line. 


Previous Line — k, CNTRL-P, and — 

Syntax: k 
CNTRL-P 
(up arrow) 

Function: Moves the cursor up one line, remaining in the same 
column. If a count is given then the cursor is moved 
count lines. 

Syntax: - 

Function: Moves the cursor up to the beginning of the previous 
line. If a count is given then the cursor is moved up a 


count lines. 


Beginning of Line — 0 and ~* 


Syntax: 
0 
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Function: Moves the cursor to the beginning of the current line. 
Note that 0 always moves the cursor to the first character 
of the current line. The caret (*) works somewhat 
differently: it moves to the first character on a line that is 
not a tab or aspace. This is useful when editing files that 


& have a great deal of indentation, such as program texts. 
End of Line— $ 


Syntax: $ 


Function: Moves the cursor to the end of the current line. Note 
that the cursor resides on top of the last character on the 
line. If a count is given, then the cursor is moved for- 
ward count— 1 lines to the end of the line. 


Goto Line—- G 

Syntax: [linenumber|G 

Function: Moves the cursor to the beginning of the line specified by 
linenumber. If no linenumber is given, the cursor moves 
to the beginning of the last line in the file. To find the 


line number of the current line, use CNTRL-G. 


Column — | 


Syntax: — [column]| 


Function: Moves the cursor to the column in the current line given 
by column. If no column is given then the cursor is 
moved to the first column in the current line. 


Word Forward — w and W 


Syntax: w 
Ww 


Function: Moves the cursor forward to the beginning of the next 
word. The lowercase w command searches for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase W command searches for a 
word defined as a string of nonwhitespace characters. 


Ze Back Word— bandB 
w Syntax: b 


B 


Function: Moves the cursor backward to the beginning of a word. 
The lowercase b command searches backward for a word 
defined as a string of alphanumeric characters separated 
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by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase B command searches for a 
word defined as a string of non-whitespace characters. If 
the cursor is already within a word, then it moves back- 
ward to the beginning of that word. 


End—- eand E 


Syntax: e 


1D 


Function: Moves the cursor to the end of a word. The lowercase e 
command moves the cursor to the last character of a 
word, where a word is defined as a string of alphanumeric 
characters separated by punctuation or whitespace (i.e., 
tab, newline, or space characters). The uppercase E 
moves the cursor to the last character of a word where a 
word is defined as a string of nonwhitespace characters. 
If the cursor is already within a word, then it moves to 
the end of that word. 


Sentence — ( and ) 


Syntax: ( 
) 


Function: Moves the cursor to the beginning (left parenthesis) or 
end of a sentence (right parenthesis). A sentence is 
defined as a sequence of characters ending with a period 
(.), question mark (?), or exclamation mark (!), fol- 
lowed by either two spaces or a newline. A sentence 
begins on the first nonwhitespace character following a 
preceding sentence. Sentences are also delimited by para- 
graph and section delimiters. See below. 


Paragraph — { and } 


Syntax: } 


Function: Moves the cursor to the beginning ({) or end (}) of a 
paragraph. A paragraph is defined with the paragraphs 
option. By default, paragraphs are delimited by the nroff 


macros “Shh. ab!’ °° eee ane io”. Paga- 
graphs also begin after empty lines. 


Section — [[{ and ]] 


Syntax: |] 
[I 


Function: Moves the cursor to the beginning ([[) or end (]]) of a 
section. A section is defined with the sections option. By 
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default, sections are delimited by the nroff macros ‘‘.NH”’ 
and ‘‘.SH’’. Sections also start at formfeeds (CNTRL-L) 
and at lines beginning with a brace ({). 

Match Delimiter -— % 


Syntax: % 


Function: Moves the cursor to a matching delimiter, where a del- 
imiter is a parenthesis, a bracket, or a brace. This is use- 
ful when matching pairs of nested parentheses, brackets, 
and braces. 


Home —- H 
Syntax: — [offset]H 


Function: Moves the cursor to upper left corner of screen. Use 
this command to quickly move to the top of the screen. 
If an offset is given, then the cursor is homed offeet-1 
number of lines from the top of the screen. Note that 
the command ‘‘dH”’’ deletes all lines from the current line 
to the top line shown on the screen. 


Middle Screen — M 


Syntax: M 


Function: Moves the cursor to the beginning of the screen’s middle 
line. Use this command to quickly move to the middle of 
the screen from either the top or the bottom. Note that 
the command ‘‘dM”’ deletes from the current line to the 
line specified by the M command. 


Lower Screen — L 
Syntax: [ offeet] L 


Function: Moves the cursor to the lowest line on the screen. Use 
this command to quickly move to the bottom of the 
screen. If an offeet is given, then the cursor is homed 
offeet-1 number of lines from the bottom of the screen. 
Note that the command ‘‘dL’’ deletes all lines from the 
current line to the bottom line shown on the screen. 


Previous Context — “and ” 
Syntax: $i 


“character 


as 


‘character 
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Function: Moves the cursor to previous context or to context 
marked with the m command. If the single quotation 
mark or back quotation mark is doubled, then the cursor 
is moved to previous context. If a single character is 
given after either quotation mark, then the cursor is 
moved to the location of the specified mark as defined by 
the m command. Previous context is the location in the 
file of the last ‘‘nonrelative’’ cursor movement. The sin- 
gle quotation mark ( ’) syntax is used to move to the 
beginning of the line representing the previous context. 
The back quotation mark (*) syntax is used to move to 
the previous context withtn a line. 


The Screen Commands 


The screen commands are not cursor movement commands and can- 
not be used in delete commands as the delimiters of text objects. 
However, the screen commands do move the cursor and are useful 
in paging or scrolling through a file. These commands are described 
below: 


Page — CNTRL-U and CNTRL-D 


Syntax: [ size] CNTRL-U 
[ size] CNTRL-D 


Function: Scrolls the screen up a half window (CNTRL-U) or down a 
half window (CNTRL-D). If size is given, then the scroll 
is etze number of lines. This value is remembered for all 
later scrolling commands. 


Scroll — CNTRL-F and CNTRL-B 


Syntax: CNTRL-F 
CNTRL-B 


Function: Pages screen forward and backward. Two lines of con- 
tinuity are kept between pages if possible. A preceding 
count gives the number of pages to move forward or 
backward. 


Status — CNTRL-G 


Syntax: BELL 
CNTRL-G 


Function: Prints vi status on status line. This gives you the name of ry 
the file you are editing, whether it has been modified, the 


current line number, the number of lines in the file, and 
the percentage of the file (in lines) that precedes the cur- 
sor. 
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Zero Screen — 2 


Syntax: [linenumber]z[ size] RETURN 


[linenumber]|z[ size]. 
[linenumber]z|size]— 

& Function: Redraws the display with the current line placed at or 
‘‘veroed’’ at the top, middle, or bottom of the screen, 


respectively. If you give a size, then the number of lines 
displayed is equal to size. If a preceding linenumber is 
given, then the given line is placed at the top of the 
screen. If the last argument is a RETURN, then the 
current line is placed at the top of the screen. If the last 
argument is a period (.), then the current line is placed 
in the middle of the screen. If the last argument is a 
minus sign (- }, then the current line is placed at the 
bottom of the screen. 


Redraw — CNTRL-R or CNTRL-L 


Syntax: CNTRL-R 
CNTRL-L 


Function: Redraws the screen. Use this command to erase any sys- 
tem messages that may scramble your screen. Note that 
system messages do not affect the file you are editing. 


Tezrt Insertion 


The text insertion commands always place you in insert mode. Exit 
from insert mode is always done by pressing ESC. The following 
insertion commands are ‘‘pure’’ insertion commands; no text is 
deleted when you use them. This differs from the text modification 
commands change, replace, and substitute, which delete and then 
insert text in one operation. 


Insert — i andI 


Syntax: i[tezt]ESC 
I[tezt]ESC 


Function: Insert tert in editing buffer. The lowercase i command 
places you in insert mode. Tezt is inserted before the 
character beneath the cursor. To insert a newline, just 
‘oe press aRETURN. Exit insert mode by typing the ESC key. 

The uppercase I command places you in insert mode, but 
begins text insertion at the beginning of the current line, 
rather than before the cursor. 


Append— aandA 
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Syntax:  al[tezt]ESC 
A[tezt]ESC 


Function: Appends tezt to the editing buffer. The lowercase a com- 
mand works ezactly like the lowercase i command, except 
that text insertion begins after the cursor and not before. 
This is the one way to add text to the end of a line. The 
uppercase A command begins appending text at the end 
of the current line rather than after the cursor. 


Open New Line — oandO 


Syntax:  oftezt]ESC 
O[tert]ESC 


Function: Opens a new line and inserts text. The lowercase 0 com- 
mand opens a new line below the current line; uppercase 
O opens a new line above the current line. After the new 
line has been opened, both these commands work like 
the I command. 


Tezt Deletion 


Many of the text deletion commands use the letter ‘‘d’’ as an opera- 
tor. This operator deletes text objects delimited by the cursor and a 
cursor movement command. Deleted text is always saved away in a 
buffer. The delete commands are described below: 


Delete Character— x and X 


Syntax: x 


X 


Function: Deletes a character. The lowercase x command deletes 
the character beneath the cursor. With a preceding 
count, count characters are deleted to the right beginning 
with the character beneath the cursor. This is a quick and 
easy way to delete a few characters. The uppercase X 
command deletes the character just before the cursor. 
With a preceding count, count characters are deleted back- 
ward, beginning with the character just before the cursor. 


Delete —- dandD 


Syntax: dcursor-movement 
dd 


D 


Function: Deletes a text object. The lowercase d command takes a 
cursor-movement as an argument. If the cursor-movement 
is an intraline command, then deletion takes place from 
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the cursor to the end of the text object delimited by the 
cursor-movement . Deletion forward deletes the character 
beneath the cursor; deletion backward does not. If the 
cursor-movement is a multiline command, then deletion 
takes place from and including the current line to the text 
object delimited by the cursor-movement . 


The dd command deletes whole lines. The uppercase D command 
deletes from and including the cursor to the end of the current line. 


Deleted text is automatically pushed on a stack of buffers numbered 
1 through 9. The most recently deleted text is also placed in a spe- 
cial delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation 
mark (”) to specify the number of the buffer for delete, put, and 
yank commands. The buffers 1 through 9 can be accessed with the 
p and P (put) commands by appending the double quotation mark 
(”) to the number of the buffer. For example 


"4p 
puts the contents of delete buffer number 4 in your editing buffer 


just below the current line. Note that the last deleted text is ‘‘put’’ 
by default and does not need a preceding buffer number. 


Tert Modtfication 


The text modification commands all involve the replacement of text 
with other text. This means that some text will necessarily be 
deleted. All text modification commands can be ‘‘undone’’ with the 
u command, discussed below: 


Undo —- uandU 


Syntax: u 


U 


Function: Undoes the last insert or delete command. The lowercase 
u command undoes the last insert or delete command. 
This means that after an insert, u deletes text; and after a 
delete, u inserts text. For the purposes of undo, all text 
modification commands are considered insertions. 


The uppercase U command restores the current line to its 
state before it was edited, no matter how many times the 
current line has been edited since you moved to it. 
Repeat — 
Syntax: ° 
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Function: Repeats the last insert or delete command. A special case 
exists for repeating the p and P ‘‘put’’ commands. When 
these commands are preceded by the name of a delete 
buffer, then successive u commands print out the con- 
tents of the delete buffers. 


Change — c andC 


Syntax: ccursor-movement tezr{ESC 
CteztESC 
ccteztESC 


Function: Changes a text object and replaces it with tert . Text is 
inserted as with the i command. A dollar sign ($) marks 
the extent of the change. The c command changes arbi- 
trary text objects delimited by the cursor and a cursor- 
movement . The C and cc commands affect whole lines 
and are identical in function. 


Replace — randR 


Syntax: rchar 
RtezfESC 


Function: Overstrikes character or line with char or tezt , respec- 
tively. Use r to overstrike a single character and R to 
overstrike a whole line. A count multiplies the replace- 
ment text count times. 


Substitute — s andS 


Syntax: sterf{ESC 
SterfESC 


Function: Substitutes current character or current line with tezt. Use 
s to replace a single character with new text. Use S to 
replace the current line with new text. If a preceding 
count is given, then tezt substitutes for count number of 
characters or lines depending on whether the command is 
s or S, respectively. 


Filter — ! 
Syntax: !cursor-movement cmdRETURN 


Function: Filters the text object delimited by the cursor and cursor- 
movement through the command, cmd. For example, the 
following command sorts all lines between the cursor and 
the bottom of the screen, substituting the designated lines 
with the sorted lines: 


{Lsort 
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Arguments and shell metacharacters may be included as 
part of cmd; however, standard input and output are 
always associated with the text object being filtered. 


Join Lines — J 


Syntax: J 


Function: Joins the current line with the following line. If a count 
is given, then count lines are Joined. 


Shift - < and > 


Syntax: > [cursor-movement 
< [cursor-movement 
>> 
<< 


Function: Shifts text left (>) or right (<). Text is shifted by the 
value of the option shiftwidth, which is normally set to 
eight spaces. Both the > and < commands shift all lines 
in the text object delimited by the current line and 
cursor-movement. The >> and << commands affect 
whole lines. All versions of the command can take a 
preceding count that acts to multiply the number of 
objects affected. 


Tert Movement 


The text movement commands move text in and out of the named 
buffers a-z and out of the delete buffers 1-9. These commands 
either ‘‘yank’’ text out of the editing buffer and into a named buffer 
or ‘‘put’’ text into the editing buffer from a named buffer or a delete 
buffer. By default, text is put and yanked from the ‘‘unnamed 
buffer’’, which is also where the most recently deleted text is placed. 
Thus it is quite reasonable to delete text, move your cursor to the 
location where you want the deleted text placed, and then put the 
text back into the editing buffer at this new location with the por P 
command. 


The named buffers are most useful for keeping track of several 
chunks of text that you want to keep on hand for later access, move- 
ment, or rearrangement. These buffers are named with the letters 


‘‘a’’ through ‘‘z’’. To refer to one of these buffers (or one of the 

re numbered delete buffers) in a command such as put, yank, or 

& delete, use a quotation mark. For example, to yank a line into the 
buffer named a, type: 


” 


ayy 


To put this text back into the file, type: 
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"ap 


If you delete text into the buffer named A rather than a, then text Is 
appended to the buffer. 


Note that the contents of the named buffers are not destroyed when 
you switch files. Therefore, you can delete or yank text into a 
buffer, switch files, and then do a put. Buffer contents are destroyed 
when you exit the editor, so be careful. 


Put — pandP 


Syntax: ["alphanumenic]p 
["alphanumeric|P 


Function: Puts text from a buffer into the editing buffer. If no 
buffer name is specified, then text is put from the 
unnamed buffer. The lowercase p command puts text 
either below the current line or after the cursor, depend- 
ing on whether the buffer contains a partial line or not. 
The uppercase P command puts text either above the 
current line or before the cursor, again depending on 
whether the buffer contains a partial line or not. 


Yank — y and Y 


Syntax: ["letter]ycursor-movement “A 
["letterlyy 


("letter] Y 


Function: Copies text in the editing buffer to a named buffer. If no 
buffer name is specified, then text is yanked into the 
unnamed buffer. If an uppercase letter is used, then text 
is appended to the buffer and does not overwrite and des- 
troy the previous contents. When a curseor-movement is 
given as an argument, the delimited text object is yanked. 
The Y and yy commands yank a single line, or, if a 
preceding count is given, multiple lines can be yanked. 


Searching 


The search commands search either forward or backward in the edit- 
ing buffer for text that matches a given regular expression. 


Search — / and? fy 


Syntax:  /[pattern]/[offeet]RETURN 
/|pattern|RETURN 
? [pattern]? [offset] RETURN 
? Heri RETURN 
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Function: Searches forward (/) or backward (?) for pattern. A 
string is actually a regular expression. The trailing delim- 
iter is not required. If no pattern is given, then last pat- 
tern searched for is used. After the second delimiter, an 
offset may be given, specifying the beginning of a line 
relative to the line on which pattern was found. For 
example 


/word/- 


finds the beginning of the line immediately preceding the 
line containing ‘‘word’’ and 


/word/+ 2 
finds the beginning of the line two lines after the line 
containing ‘‘word’’. See also the tgnorecase and magic 
options. 


Next String — nandN 


Syntax: n 


N 


Function: Repeats the last search cominand. The n command 
repeats the search in the same direction as the last search 
command. The N command repeats the search in the 
opposite direction of the last search command. 


Find Character — f andF 


Syntax: fchar 
F char 


’ 


Function: Finds character char on the current line. The lowercase f 
searches forward on the line; the uppercase F searches 
backward. The semicolon (;) repeats the last character 
search. The comma (,) reverses the direction of the 
search. 


To Character — t and T 


Syntax: tchar 
Tchar 


, 


’ 


Function: Moves the cursor up to but not on to char. The semi- 
colon (;) repeats the last character search. The comma 
(,) reverses the direction of the search. 
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Mark — m 
Syntax: mletter 


Function: Marks a place in the file with a lowercase letter. You can 
move to a mark using the ‘‘to mark’’ commands 
described below. It is often useful to create a mark, 
move the cursor, and then delete from the cursor to the 
mark ‘‘a’’ with the following command: 


d‘a 


To Mark — ’ and ~* 


Syntax: letter 
‘letter 


Function: Move to letter. These commands let you move to the 
location of a mark. Marks are denoted by single lower- 
case alphabetic characters. Before you can move to a 
mark, it must first be created with the mcommand. The 
back quotation mark ( ’) moves you to the exact location 
of the mark within a line; the forward quotation mark ( ’) 
moves you to the beginning of the line containing the 
mark. Note that these commands are also legal cursor 
movement commands. 


Ertt and Escape Commands 


There are several commands that are used to escape from vi com- 
mand mode and to exit the editor. These are described below: 


Ex Escape — 
Syntax: 


Function: Enters ex escape mode to execute an ex command. The 
colon appears on the status line as a prompt for an ex 
command. You then can enter an ex command line ter- 
minated by either a RETURN or an ESC and the ex com- 
mand will execute. You are then prompted to type 
RETURN to return to vi command mode. During the 
input of the ex command line or during execution of the 
ex command you may press INTERRUPT to abort what 


you are doing and return to vi command mode. 
Exit Editor— ZZ ‘ry 


Syntax: ZZ, 


Function: Exit vi and write out the file if any changes have been 
made. This returns you to the shell from which you 
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invoked vi. 
Quit to Ex —- Q 
Syntax: Q 
Function: Enters the ex editor. When you do this, you will still be 


editing the same file. You can return to vi by typing the 
vi command from ex. 


Ex Commands 


Typing the colon (:) escape command when in command mode, pro- 
duces a colon prompt on the status line. This prompt is for a com- 
mand available in the line-oriented editor, ex. In general, ex com- 
mands let you write out or read in files, escape to the shell, or switch 
editing files. 


Many of these commands perform actions that affect the ‘‘current’’ 
file by default. The current file is normally the file that you named 
when you invoked vi, although the current file can be changed with 
the ‘‘file’’ command, f, or with the ‘‘next’? command, n. In most 
respects, these commands are identical to similar commands for the 
editor, ed. All such ex commands are aborted by either a RETURN 
or an ESC. We shall use a RETURN in our examples. Command 
entry is terminated by typing an INTERRUPT. 


Command Structure 


Most ex command names are English words, and initial prefixes of 
the words are acceptable abbreviations. In descriptions, only the 
abbreviation is discussed, since this is the most frequently used form 
of the command. The ambiguity of abbreviations is resolved in 
favor of the more commonly used commands. As an example, the 
command substitute can be abbreviated s while the shortest avail- 
able abbreviation for the set command is se. 


Most commands accept prefix addresses specifying the lines in the 
file that they are to affect. A number of commands also may take a 
trailing count specifying the number of lines to be involved in the 
command. Counts are rounded down if necessary. Thus, the com- 
mand ‘‘10p’’ will print the tenth line in the buffer while ‘‘move 5”’ 
will move the current line after line 5. 


Some commands take other information or parameters, stated after 
the command name. Examples might be option names in a set com- 
mand, such as ‘‘set number’’, a filename in an edit command, a reg- 
ular expression in a substitute command, or a target address for a 
copy command, such as 
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1,5 copy 25 


A number of commands have variants. The variant form of the 
command is invoked by placing an exclamation mark (!) immedi- 
ately after the command name. Some of the default variants may be 
controlled by options; in this case, the exclamation mark turns off 
the meaning of the default. 

In addition, many commands take flags, including the characters ‘‘p’’ 
and ‘‘l’’. A ‘‘p’’ or ‘‘l’’ must be preceded by a blank or tab. In this 
case, the command abbreviated by these characters is executed after 
the command completes. Since ex normally prints the new current 
line after each change, p is rarely necessary. Any number of plus 
(+) or minus (- ) characters may also be given with these flags. If 
they appear, the specified offset is applied to the current line value 
before the printing command is executed. 


Most commands that change the contents of the editor buffer give 
feedback if the scope of the change exceeds a threshold given by the 
report option. This feedback helps to detect undesirably large 
changes so that they may be quickly and easily reversed with the 
undo command. After commands with global effect, you will be 
informed if the net change in the number of lines in the buffer dur- 
ing this command exceeds this threshold. 


Command Addressing 

The following specifies the line addressing syntax for ex commands: 
The current line. Most commands leave the current 
line as the last line which they affect. The default 
address for most commands is the current line, thus 


‘f’ is rarely used alone as an address. 


n The nth line in the editor’s buffer, lines being num- 
bered sequentially from 1. 


$ The last line in the buffer. 

% An abbreviation for ‘‘1,$’’, the entire buffer. 

+nor-—n An offset, n relative to the current buffer line. The 
forms ‘‘.+3’ ‘‘+3’’ and ‘+++’ are. all 


equivalent. If the current line is line 100 they all 
address line 103. 


/pattern/ or ? pattern? 
Scan forward and backward respectively for a text 
matching the regular expression given by pattern. 
Scans normally wrap around the end of the buffer. 
If all that is desired is to print the next line contain- 
ing pattern, then the trailing slash (/) or question 
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mark (?) may be omitted. If pattern is omitted or 
explicitly empty, then the string matching the last 
specified regular expression is located. The forms 
‘‘RETURN’”’ and ‘'?RETURN”’ scan using the last 
named regular expression. After a_ substitute, 
‘““‘RETURN”’ and ‘“??RETURN’’ would scan using 
that substitute’s regular expression. 


or? Before each nonrelative motion of the current line 
dot (.), the previous current line is marked with a 
label, subsequently referred to with two single quo- 
tation marks (*). This makes it easy to refer or 
return to this previous context. Marks are esta- 
blished with the vi m command, using a single 
lowercase letter as the name of the mark. Marked 
lines are later referred to with the notation 


- 


Ua 
where z is the name of a mark. 


Addresses to commands consist of a series of addresses, separated 
by a colon (,) or a semicolon (;). Such address lists are evaluated 
left to right. When addresses are separated by a semicolon (;) the 
current line (.) is set to the value of the previous addressing expres- 
sion before the next address is interpreted. If more addresses are 
given than the command requires, then all but the last one or two 
are ignored. If the command takes two addresses, the first addressed 
line must precede the second in the buffer. Null address 
specifications are permitted in a list of addresses, the default in this 


case is the current line ‘‘.’’; thus ‘‘,100’’ is equivalent to ‘‘.,100’’. It 
is an error to give a prefix address to a command which expects 
none. 


Command Format 
The following is the format for all ex commands: 
[ address] [command] [!] [parameters] [count] | flags] 


All parts are optional depending on the particular command and its 
options. The following section describes specific commands. 


& Argument List Commands 
The argument list commands allow you to work on a set of files, by 


remembering the list of filenames that are specified when you invoke 
vi. The args command lets you examine this list of filenames. The 
file command gives you information about the current file. The n 
(next) command lets you either edit the next file in the argument 
list or change the list. And the rewind command lets you restart 
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editing the files in the list. All of these commands are described 
below: 


args The members of the argument list are printed, with 
the current argument delimited by brackets. For 
example, a list might look like this: 


filel file2 [file3] file4 file5 


The current file is file’. 


f Prints the current filename, whether it has been 
modified since the last write command, whether it is 
readonly, the current linenumber, the number of 
lines in the buffer, and the percentage of the buffer 
that you have edited. In the rare case that the 
current file is ‘‘[Not edited]’’ this is noted also; in 
this case you have to use the form ‘‘w!”’ to write to 
the file, since the editor is not sure that a w com- 
mand will not destroy a file unrelated to the current 
contents of the buffer. 


f file The current filename is changed to file which is con- 
sidered ‘‘[Not edited]’’. 


n The next file in the command line argument list is 
edited. 


n! This variant suppresses warnings about the 
modifications to the buffer not having been written 
out, discarding irretrievably any changes that may 
have been made. 


n [+ command] filelist 
The specified filelist is expanded and the resulting list 
replaces the current argument list; the first file in the 
new list is then edited. If command is given (it must 
contain no spaces), then it is executed after editing 
the first such file. 


rew The argument list is rewound, and the first file in the 
list 1s edited. 


rew! Rewinds the argument list discarding any changes 
made to the current buffer. 


Edit Commands 


To edit a file other than the one you are currently editing, you will 
often use one of the variations of the e command. 
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In the following discussions, note that the name of the current file is 
always remembered by vi and is specified by a percent sign (%). The 
name of the previous file in the editing buffer is specified by a 
number sign ( #). 


YU The edit commands are described below: 
e file Used to begin an editing session on a new file. The edi- 


tor first checks to see if the buffer has been modified 
since the last w command was issued. If it has been, a 
warning is issued and the command is aborted. The com- 
mand otherwise deletes the entire contents of the editor 
buffer, makes the named file the current file and prints 
the new filename. After ensuring that this file is sensible, 
(i.e., that it is not a binary file, directory, or a device), 
the editor reads the file into its buffer. If the read of the 
file completes without error, the number of lines and 
characters read is printed on the status line. If there were 
any non— ASCII characters in the file they are stripped of 
their non— ASCII high bits, and any null characters in the 
file are discarded. If none of these errors occurred, the 
file is considered edited. If the last line of the input file is 
missing the trailing newline character, it is supplied and a 
complaint issued. The current line is initially the first line 
of the file. 


e! file This variant form suppresses the complaint about 
modifications having been made and not written from the 
editor buffer, thus discarding all changes that have been 
made before editing the new file. 


e +n file 
Causes the editor to begin editing at line n rather than at 
the first line. The argument n may also be an editor com- 
mand containing no spaces; for example, ‘‘+ /pattern’’. 
CNTRL-* 


This is a shorthand equivalent for ‘‘:e #RETURN’”’, 
which returns to the previous position in the last edited 
file. If you do not want to write the file you should use 
‘‘se! #RETURN”’ instead. 


Wnte Commands 


The write commands let you write out all or part of your editing 
buffer to either the current file or to some other file. These com- 


mands are described below: 


w file 
Writes changes made back to file, printing the number of lines 
and characters written. Normally, fle is omitted and the buffer 
is written to the name of the current file. If file is specified, 
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then text will be written to that file. The editor writes to a file 
only if it is the current file and is edited, or if the file does not 
exist. Otherwise, you must give the variant form w! to force 
the write. If the file does not exist it is created. The current 
filename is changed only if there is no current filename; the 
current line is never changed. 


If an error occurs while writing the current and edited file, the 
editor prints 


No write since last change 
even if the buffer had not previously been modified. 


w>> file 
Appends the buffer contents at the end of an existing file. Pre- 
vious file contents are not destroyed. 


w! name 
Overrides the checking of the normal write command, and 
writes to any file that the system permits. 


w !command 
Writes the specified lines into command. Note the difference 
between 


w! file 
which overrides checks and 
w !comd 


which writes to a command. The output of this command is 
displayed on the screen and not inserted in the editing buffer. 


Read Commands 


The read commands let you read text into your editing buffer at any 
location you specify. The text you read in must be at least one line 
long, and can be either a file or the output from a command. 


r file Places a copy of the text of the given file in the editing 
buffer after the specified line. If no file is given then the 
current filename is used. The current filename is not 
changed unless there is none, in which case the file 
becomes the current name. If the file buffer is empty and 
there is no current name then this is treated as an e com- 
mand. 


Address 0 is legal for this command and causes the file to 
be read at the beginning of the buffer. Statistics are given 
as for the e command when the r successfully terminates. 
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After an r the current line is the last line read. 


r [command 
Reads the output of command into the buffer after the 
specified line. A blank or tab before the exclamation 


& mark (!) is mandatory. 


Qut Commands 


There are several ways to exit vi. Some abort the editing session, 
some write out the editing buffer before exiting, and some warn you 
if you decide to exit without writing out the buffer. All of these 
ways of exiting are described below: 


q Exits vi. No automatic write of the editor buffer to a file 
is performed. However, vi issues a warning message if 
the file has changed since the last w command was 
issued, and does not quit. Vi will also issue a diagnostic 
if there are more files in the argument list left to edit. 
Normally, you will wish to save your changes, and you 
should give a w command. If you wish to discard them, 
use the ‘‘q!’’ command variant. 


q! Quits from the editor, discarding changes to the buffer 
without complaint. 


wq name Like a wand then aq command. 


wq! name This variant overrides checking of the w command so 
that you can write to file that the system allows. 


x name If any changes have been made and not written, writes 
the buffer out and then quits. Otherwise, it just quits. 


Global and Substitute Commands 


The global and substitute commands allow you to perform complex 
changes to a file in a single command. Learning how to use these 
commands is a must for the serious user of vi. 


g/pattern/cmde 
The g command has two distinct phases. In the first 
phase, each line matching pattern in the editing buffer is 


YY marked. Next, the given command list is executed with 


the current line, dot (.), initially set to each marked line. 


The command list consists of the remaining commands 
on the current input line and may continue to multiple 
lines by ending all but the last such line with a backslash 
(\). This multiple-line option will not work from within 
vi, you must switch to ex to do it. If emde (or the trailing 
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slash (/) delimiter) is omitted, then each line matching 
pattern is printed. 


The g command itself may not appear in emds. The 
options autoprint and autoindent are inhibited during a glo- 
bal command and the value of the report option is tem- 
porarily infinite, in deference to a report for the entire glo- 
bal. Finally, the context mark ( ’) or (‘) is set to the 
value of the current line (.) before the global command 
begins and is not changed during a global command. 


The following global commands, most of them substitu- 
tions, cover the most frequent uses of the global com- 
mand. 


g/s1/p This command simply prints all lines that contain 
the string ‘‘sl’’. 


g/s1/s//s2/ This command substitutes the first occurrence of 
‘fs1’’ on all lines that contain it with the string 
aot pe 


g/sl1/s//s2/g This command substitutes all occurrences of ‘‘sl”’ 
with the string ‘‘s2’’. This includes mutItiple 
occurrences of ‘‘sl’’ on a line. 


g/s1/s//s2/gp This command works the same as the preceding 
example, except that in addition, all changed lines 
are printed on the screen. 


g/sl/s//s2/gc This command asks you to confirm that you want to 
make each substitution of the string ‘‘sl’’ with the 
string ‘‘s2’’. If you type a ‘“‘y’’ then the given sub- 
stitution is made, otherwise it is not. 


g/s0/s/s1/s2/g This command marks all those lines that contain the 
string ‘‘s0’’, and then for those lines only, it substi- 
tutes all occurrences of the string ‘‘sl’’ with ‘‘s2’’. 


g!/pattern/cmds This variant form of g runs emds at each line not 
matching pattern. 


s/pattern/repl/ options 
On each specified line, the first instance of text 
matching the regular expression pattern is replaced 
by the replacement text repl. If the global indicator 
option character ‘‘g’’ appears, then all instances on 
a line are substituted. If the confirm indication char- 
acter ‘‘c’’ appears, then before each substitution the 
line to be substituted is printed on the screen with 
the string to be substituted marked with caret ( *) 
characters. By typing a ‘‘y’’, you cause the substitu- 


tion to be performed; any other input causes no 
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change to take place. After an s command the 
current line is the last line substituted. 


v/pattern{emds A synonym for the global command variant g!, run- 
ning the specified emds on each line that does not 
match pattern. 


Tezt Movement Commands 


The text movement commands are largely superseded by commands 
available in vi command mode. However, the following two com- 
mands are still quite useful. 


co addr flags A copy of the specified lines is placed after addr, 
which may be ‘‘0’’. The current line ‘‘.’’ addresses 
the last line of the copy. 


[range]maddr The m command moves the lines specified by range 
after the line given by addr. For example, ‘‘m+’’ 
swaps the current line and the following line, since 
the default range is just the current line. The first 
of the moved lines becomes the current line (dot). 


Shell Escape Commands 


You will often want to escape from the editor to execute normal 
commands. You may also want to change your working directory so 
that your editing can be done with respect to a different working 
directory. These operations are described below: 


cd directory The specified directory becomes the current direc- 
tory. If no directory is specified, the current value 
of the home option is used as the target directory. 
After acd the current file is not considered to have 
been edited so that write restrictions on preexisting 
files still apply. 


sh A new shell is created. You may invoke as many 
commands as you like in this shell. To return to vi, 
type a CNTRL-D to terminate the shell. 


!command The remainder of the line after the exclamation (!) 

is sent to a shell to be executed. Within the text of 

f command the characters ‘‘%’ and ‘‘#’’ are 

expanded as the filenames of the current file and 

the last edited file and the character ‘‘!’’ is replaced 

with the text of the previous command. Thus, in 

particular, ‘‘!!’’ repeats the last such shell escape. If 

any such expansion is performed, the expanded line 

is echoed. The current line is unchanged by this 
command. 
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If there has been ‘‘[No write]’’ of the buffer contents since the last 
change to the editing buffer, then a diagnostic is printed before the 
command is executed as a warning. A single exclamation (!) is 
printed when the command completes. 


Other Commands 


The foliowing command descriptions explain how to use miscellane- 
ous ex commands that do not fit into the above categories: 


abbr Maps the first argument to the following string. For 
example, the following command 


:abbr rainbow yellow green blue red 


maps ‘‘rainbow’’ to ‘‘yellow green blue red’’. Abbrevia- 
tions can be turned off with the unabbreviate command, 
as in: 


‘una rainbow 


map, map! 
Maps any character or escape sequence to an existing 
command sequence. Characters mapped with map! work 
only in insert mode, while characters mapped with map 
work only in command mode. 


nu Prints each specified line preceded by its buffer line 
number. The current line is left at the last line printed. 
To get automatic line numbering of lines in the buffer, 
set the number option. 


preserve The current editor buffer is saved as though the system 
had just crashed. This command is for use only in emer- 
gencies when a w command has resulted in an error and 
you don’t know how to save your work. 


= Prints the line number of the addressed line. The current 
line is unchanged. 


recover file 
Recovers file from the system save area. The system 
saves a copy of the editing buffer only if you have made 
changes to the file, the system crashes, or you execute a 
preserve command. Except when you use preserve you 
will be notified by mail when a file is saved. 


set argument 
With no arguments, set prints those options whose values 
have been changed from their defaults; with the argu- 
ment all it prints all of the option values. 
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Giving an option name followed by a question mark (?) causes the 
current value of that option to be printed. The ‘‘?’’ is unnecessary 
unless the option is Boolean valued. Switch options are given values 
either with 


oe set option 
to turn them on or 


set nooption 


to turn them off. String and numeric options are assigned with 
set option=value 


More than one parameter may be given to set; all are interpreted 
from left to right. 


tag label 
The focus of editing switches to the location of label. If neces- 
sary, vi will switch to a different file in the current directory to 
find label. If you have modified the current file before giving a 
tag command, you must first write it out. If you give another 
tag command with no argument, then the previous label is used. 


Similarly, if you type only a CNTRL-], vi searches for the word 
immediately after the cursor as a tag. This is equivalent to typ- 
ing ‘‘:tag’’, this word, and then a RETURN. 


The tags file is normally created by a program such as ctags, and 
consists of a number of lines with three fields separated by 
blanks or tabs. The first field gives the name of the tag, the 
second the name of the file where the tag resides, and the third 
gives an addressing form which can be used by the editor to find 
the tag. This field is usually a contextual scan using / pattern / 
to be immune to minor changes in the file. Such scans are 
always performed as if the nomagtc option was set. The tag 
names in the tags file must be sorted alphabetically. There are a 
number of options that can be set to affect the vi environment. 
These can be set with the ex set command either while editing 
or immediately after vi is invoked in the vi start-up file, .erre. 


The first thing that must be done before you can use vi, is to set the 
terminal type so that vi understands how to talk to the particular ter- 
minal you are using. 


Vw Each time vi is invoked, it reads commands from the file named 

.ezre in your home directory. This file normally sets the user’s pre- 
ferred options so that they need not be set manually each time you 
invoke vi. Each of the options is described in detail below. 
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Options 


There are only two kinds of options: switch options and string 
options. A switch option is either on or off. A switch is turned off 
by prefixing the word no to the name of the switch within a set com- 
mand. String options are strings of characters that are assigned 
values with the syntax option=string. Multiple options may be 
specified on a line. Vsoptions are listed below: 


autoindent, ai default: noai 

Can be used to ease the preparation of structured program text. 
For each line created by an append, change, insert, open, or 
substitute operation, vi looks at the preceding line to determine 
and insert an appropriate amount of indentation. To back the 
cursor up to the preceding tab stop, you can type CNTRL-D. 
The tab stops going backward are defined as multiples of the 
shiftwidth option. You cannot backspace over the indent, except 
by typing a CNTRL-D. 


Specially processed in this mode is a line with no characters 

added to it, which turns into a completely blank line {the whi- 

tespace provided for the autoindent is discarded.) Also specially 
processed in this mode are lines beginning with a caret (*) and 
immediately followed by a CNTRL-D. This causes the input to 

be repositioned at the beginning of the line, but retains the pre- 

vious indent for the next line. Similarly, a ‘‘0’”’ followed by a 
CNTRL-D repositions the cursor at the beginning but without “A 
retaining the previous indent. Autoindent doesn’t happen in glo- 

bal commands. 


autoprint ap default: ap 
Causes the current line to be printed after each ex copy, move, 
or substitute command. This has the same effect as supplying a 
trailing ‘‘p’’ to each such command. Autoprint is suppressed in 
globals, and only applies to the last of many commands on a 
line. 


autowrite, aw default: noaw 
Causes the contents of the buffer to be automatically written to 
the current file if you have modified it when you give a next, 
rewind, tag, or ! command, or a CNTRL-* (switch files) or 
CNTRL-] (tag go to) command. 


beautify, bf default: nobeautify 
Causes all control characters except tab, new line and formfeed 
to be discarded from the input. A complaint is registered the 


first time a backspace character is discarded. Beautify does not 
apply to command input. 


directory, dir default: dir=/tmp 
Specifies the directory in which vi places the editing buffer file. 
If this directory is not writable, then the editor will exit abruptly 
when it fails to write to the buffer file. 
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edcompatible default: noedcom patible 
Causes the presence or absence of g and c suffixes on substitute 
commands to be remembered, and to be toggled on and off by 
repeating the suffixes. The suffix r causes the substitution to be 
like the command, instead of like &. 


&Y errorbells,eb default: noeb 
Error messages are preceded by a bell. If possible, the editor 


always places the error message in inverse video instead of ring- 
ing the beil. 


hardtabs, ht default: ht=8 
Gives the boundaries on which terminal hardware tabs are set or 
on which the system expands tabs. 


ignorecase, ic default: noic 
Maps all uppercase characters in the text to lowercase in regular 
expression matching. In addition, all uppercase characters in 
regular expressions are mapped to lowercase except in character 
class specifications enclosed in brackets. 


lisp default: nolisp 
Autoindent indents appropriately for LISP code, and the ( ) { } [[ 
and |] commands are modified to have meaning for LISP. 


list default: nolist 
All printed lines will be displayed unambiguously, showing tabs 
and end-of-lines. 


magic default: magic 
If nomagtc is set, the number of regular expression metacharac- 
ters is greatly reduced, with only up-arrow (*) and dollar sign 
($) having special effects. In addition the metacharacters ‘‘~’’ 
and ‘‘&’’ in replacement patterns are treated as normal charac- 
ters. All the normal metacharacters may be made magic when 
nomagic is set by preceding them with a backslash (\). 


mesg default: nomesg 
Causes write permission to be turned off to the terminal while 
you are in visual mode, if nomesg is set. This prevents people 
writing to your screen with the write command and scrambling 
your screen as you edit. 


number, n default: nonumber 
Causes all output lines to be printed with their line numbers. 


open default:open 
If set to noopen, the commands open and visual are not permit- 


ted from ex. This is set to prevent confusion resulting from 
accidental entry to open or visual mode. 


optimize, opt default: optimize 
Output of text to the screen is expedited by setting the terminal 
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so that it does not perform automatic carriage returns when 
printing more than one line of output, thus greatly speeding out- 
put on terminals without addressable cursors when text with 
leading whitespace is printed. 


paragraphs, para default: para=IPLPPPQPP TPbp 
Specifies paragraph delimiters for the { and } operations. The 
pairs of characters in the option’s value are the names of the 
nroff macros that start paragraphs. 


prompt default: prompt 
Ex input is prompted for with a colon (:). If noprompt is set, 
when ex command mode is entered with the Q command, no 
colon prompt is displayed on the status line. 


redraw default: noredraw 
The editor simulates (using great amounts of output), an intelli- 
gent terminal on a dumb terminal. Useful only at very high 
speed. 


remap default: remap 
If on, mapped characters are repeatedly tried until they are 
unchanged. For example, if o is mapped to O and O is mapped 
to /, o will map to / if remap is set, and to Oif noremap is set. 


report default: report=5 

Specifies a threshold for feedback from commands. Any com- 
mand that modifies more than the specified number of lines will 
provide feedback as to the scope of its changes. For global com- 
mands and the undo command, which have potentially far 
reaching scope, the net change in the number of lines in the 
buffer is presented at the end of the command, subject to this 
same threshold. Thus notification is suppressed during a g com- 
mand on the individual commands performed. 


scroll default: scroll= window 
Determines the number of logical lines scrolled when CNTRL-D 
is received from a terminal input in command mode, and the 
number of lines printed by a command mode z command ( dou- 
ble the value of scroll). 


sections default: sections=SHNHH HU 
Specifies the section macros for the [[ and ]] operations. The 
pairs of characters in the option’s value are the names of the 
nroff macros that start paragraphs. 


shell, sh default: sh=/bin/sh 
Gives the pathname of the shell forked for the shell escape 
command ‘‘!’’ , and by the shell command. The default is 


taken from SHELL in the environment, if present. 


shiftwidth, sw default: sw=8 
Gives the width of a software tab stop, used in reverse tabbing 
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with CNTRL-D when using autotndent to append text, and by the 
shift commands. 


showmatch, sm default: nosm 
When a) or } is typed, moves the cursor to the matching ( or { 


&Y for one second if this matching character is on the screen. 
tabstop, ts default: ts=8 


The editor expands tabs in the input file to be on tabstop boun- 
daries for the purposes of display. 


taglength, tl default: tl=0 
The first taglength characters in a tag name are significant, but 
all others are ignored. A value of zero (the default) means that 
all characters are significant. 


tags default: tags=tags /usr/lib/tags 
A path of files to be used as tag files for the tag command. A 
requested tag is searched for in the specified files, sequentially. 
By default files named tag are searched for in the current direc- 
tory and in /usr/lib. 


term default—value of shell TERM variable 
The terminal type of the output device. 


terse default: noterse 
Shorter error diagnostics are produced for the experienced user. 


warn default: warn 
Warn if there has been ‘‘[No write since last change]’’ before a 
shell escape command (1). 


window default: window=speed dependent 
This specifies the number of lines in a text window. The default 
is 8 at slow speeds (600 baud or less), 16 at medium speed 
(1200 baud), and the full screen (minus one line) at higher 
speeds. 


w300, w1200, w9600 
These are not true options but set window (above) only if the 
speed is slow (300), medium (1200), or high (9600), respec- 


tively. 
wrapscan, ws default: ws 
Searches using the regular expressions in addressing will wrap 
& around past the end of the file. 
wrapmargin, wm default: wm=0 


Defines the margin for automatic insertion of newlines during 
text input. A value of zero specifies no wrap margin. 


writeany, wa default: nowa 
Inhibits the checks normally made before write commands, 
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allowing a write to any file that the system protection mechan- 
ism will allow. 


Regular Expressions 


A reguiar expression specifies a set of strings of characters. A 
member of this set of strings is said to be matched by the regular 
expression. Vi remembers two previous regular expressions: the 
previous regular expression used in a substitute command and the 
previous regular expression used elsewhere, referred to as the previ- 
ous scanning regular expression. The previous regular expression 


can always be referred to by a null regular expression: e.g., ‘‘//’’ or 
(69 953 


The regular expressions allowed by vi are constructed in one of two 
ways depending on the setting of the magic option. The ex and vi 
default setting of magic gives quick access to a powerful set of regu- 
lar expression metacharacters. The disadvantage of magic is that the 
user must remember that these metacharacters are magic and pre- 
cede them with the backslash (\) to use them as ‘‘ordinary’’ charac- 
ters. With nomagic set, regular expressions are much simpler, there 
being only two metacharacters. The power of the other metacharac- 
ters is still available by preceding the now ordinary character with a 
‘\’. Note that ‘‘\’ is thus always a metacharacter. In this discus- 
sion the magic option is assumed. With nomagic the only special 
characters are the caret (*) at the beginning of a regular expression, > 
the dollar sign ($) at the end of a regular expression, and the 
backslash (\). The tilde (~) and the ampersand (&) also lose their 
special meanings related to the replacement pattern of a substitute. 


The following basic constructs are used to construct magic mode reg- 
ular expressions. 


char 
An ordinary character matches itself. Ordinary characters are 
any characters except a caret (°) at the beginning of a line, a 
dollar sign ($) at the end of line, a star (*) as any character 
other than the first, and any of the following characters: 


ie oe 


These characters must be escaped (i.e., preceded) by a backslash 
(\) if they are to be treated as ordinary characters. 


At the beginning of a pattern this forces the match to succeed 
only at the beginning of a line. 


$ At the end of a regular expression this forces the match to 
succeed only at the end of the line. 


Matches any single character except the newline characte :. 
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\< Forces the match to occur only at the beginning of a ‘‘word’’; 
that is, either at the beginning of a line, or just before a letter, 
digit, or underline and after a character not one of these. 


\> Similar to ‘‘\<’’, but matching the end of a ‘‘word’’, i.e. either 
the end of the line or before a character which is not a letter, a 
digit, or the underline character. 


string 

| ree any single character in the class defined by string. Most 
characters in string define themselves. A pair of characters 
separated by a dash (- ) in string defines the set of characters 
between the specified lower and upper bounds, thus ‘‘[a- z]’’ as 
a regular expression matches any single lowercase letter. If the 
first character of string is a caret ( ~) then the construct matches 
those characters which it otherwise would not. Thus ‘‘[*a— z]”’ 
matches anything but a lowercase letter or a newline. To place 
any of the characters caret, left bracket, or dash in string they 
must be escaped with a preceding backslash (\). 


The concatenation of two regular expressions first matches the left 
most regular expression and then the longest string that can be 
recognized as aregular expression. The first part of this new regular 
expression matches the first regular expression and the second part 
matches the second. Any of the single character matching regular 
expressions mentioned above may be followed by a ‘‘star’’ (*) to 
form a regular expression that matches zero or more adjacent 
occurrences of the characters matched by the prefixing regular 
expression. The tilde (~) may be used in a regular expression to 
match the text that defined the replacement part of the last s com- 
mand. A regular expression may be enclosed between the sequences 
‘‘\(?? and ‘‘\)’’ to remember the text matched by the enclosed regu- 
lar expression. This text can later be interpolated into the replace- 
ment text using the notation 


\digit 


where digit enumerates the set of remembered regular expressions. 


The basic metacharacters for the replacement pattern are the amper- 
sand (&) and the tilde (°) these are given as ‘‘\&’’ and ‘‘\”’ when 
nomagtc is set. Each instance of the ampersand is replaced by the 
characters matched by the regular expression. In the replacement 
pattern the tilde stands for the text of the previous replacement pat- 


tern. 
& Other metasequences possible in the replacement pattern are always 
introduced by a backslash (\). The sequence ‘‘\n’’ is replaced by the 


text matched by the nth regular subexpression enclosed between 
‘‘\(’? and ‘‘\)’’. When nested, parenthesized subexpressions are 
present, n is determined by counting occurrences of ‘‘\(’’ starting 
from the left. The sequences ‘‘\u’’ and ‘‘\l’’ cause the immediately 
following character in the replacement to be converted to uppercase 
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or lowercase, respectively, if this character is a letter. The sequences 
“\U”? and ‘‘\L”’ turn such conversion on, either until ‘‘\E’”’ or ‘‘\e”’ 
is encountered, or until the end of the replacement pattern. 


Limitations y 
When using vi, you should note the following limits: i 


250,000 lines in a file 

1024 characters per line 

256 characters per global command list 

128 characters per filename 

128 characters in the previous inserted and deleted text 
100 characters in a shell escape command 

63 characters in a string valued option 


30 characters in a tag name 


Credit 


This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 


The fusr /lib /exr2.18preserve program can be used to restore vi buffer 
files that were lost as a result of a system crash. The program 
searches the /tmp directory for vi buffer files and places them in the 
directory /usr/preserve. The owner can retrieve these files using the 
— roption. 


The /uer/lib /ex2.18preserve program must be placed in the system 
startup file, /etc/rc, before the command that cleans out the /tmp 
directory. See the XENIX Operations Gutde for more information on 
/etc/rc. 
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Name 


vsh — Invokes the visual shell. 


Syntax 


vsh options 


Description 


Veh is a visual command interpreter with an interface much like that 
of other Microsoft tools. This shell is recommended for casual users 
of the system and those with specialized needs that do not include 
learning the complete operating system. Note that the visual shell 
can be substituted for a user’s normal login shell by altering the 
/etc/passwd file. 


See Also 


The Microsoft Visual Shell User’s Guide 
sh(C), csh( CP) 
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Name 


wait — Awaits completion of background processes. 


Syntax 


wait 


Description 


Waits until all background processes started with an ampersand ( &) 
have finished and reports on abnormal terminations. 


Because the watt(S) system call must be executed in the parent pro- 
cess, the shell itself executes wait, without creating a new process. 


See Also 


sh(C) 


Notes 


Not all the processes of a pipeline with three or more stages are chil- fy» 


dren of the shell, and thus cannot be waited for. 


March 24, 1984 Page 1 


WALL (C) WALL (C) 


Name 


wall — Writes to all users. 


Syntax 


/etc/wall 


Description 
Wall reads a message from the standard input until an end-of-file. It 
then sends this message to all users currently logged in preceded by 
‘‘Broadcast Message from ...’’. Wall is used to warn all users, for 
example, prior to shutting down the system. 


The sender should be super-user to override any protections the 
users may have invoked. 


Files 


/dev /tty* 


& See Also 


mesg({C), write(C) 


Diagnostics 


Cannot send to ... The open on auser’s tty file has failed. 
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we — Counts lines, words and characters. 


Syntax 


we [ — lwc | [ names |] 


Description 


We counts lines, words and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for all 
named files. A word is a maximal string of characters delimited by 
spaces, tabs, or newlines. 


The options 1, w, and c may be used in any combination to specify 
that a subset of lines, words, and characters are to be reported. The 
defau!t is — lwe. 


When names are specified on the command line, they will be printed 
along with the counts. 
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Name 


what — Identifies files. 


Syntax 


what files 


Description 

What searches the given files for all occurrences of the pattern 
@ (#) and prints out what follows until the first tilde (”), greater- 
than sign ( >), new-line, backslash (\) or null character. The SCCS 
command get(CP) substitutes this string as part of the @(#) string. 
For example, if the shell procedure in file print contains 

# @(+#)this is the print program 

# @ (#)syntax: print [files] 

pr $* | Ipr 


then the command 


what print 


displays the name of the file print and the identifying strings in that 
file: 


print: 
this is the print program 
syntax: print [files] 
What is intended to be used with the get(CP) command, which 
automatically inserts identifying information, but it can also be used 
where the information is inserted manually. 


See Also 


admin(CP), get( CP) 


March 24, 1984 Page 1 


WHO (C) WHO(C) 


Name 


who — Lists who is on the system. 


Syntax 
who [ who-file ] [ am I ] 
Description 


Who, without an argument, lists the login name, terminal name, and 
login time for each current XENIX user. 


Without an argument, who examines the /etc/utmp file to obtain its 
information. If a file is given, that file is examined. Typically the 
given file will be /usr/adm/wtmp, which contains a record of all the 
logins since it was created. Then who lists logins, logouts, and 
crashes since the creation of the wtmp file. Each login is listed with 
user name, terminal name (with /dev/ suppressed), and date and 
time. When an argument is given, logouts produce a similar line 
without a user name. Reboots produce a line with x in the place of 
the device name, and a fossil time indicative of when the system 
went down. 


With two arguments, as in who am I (and also who are you), who “& 


tells who you are logged in as. 


Files 


/etc/utmp 


See Also 


getuid(S), utmp(M) 
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Name 


whodo — Determines who is doing what. 


Syntax 


/etc /whodo 


Description 


Whodo produces merged, reformatted, and dated output from the 
who(C) and ps{C) commands. 


See Also 


ps(C), who(C) 
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Name 


write — Writes to another user. 


Syntax 


write user | tty | 


Description 


Write copies lines from your terminal to that of another user. When 
first called, it sends the message: 


Message from your-logname your-tty ... 


The recipient of the message should write back at this point. Com- 
munication continues until an end-of-file is read from the terminal 
or an interrupt is sent. At that point, wnte writes 


(end of message) 


on the other terminal and exits. 


If you want to write to a user who is logged in more than once, the 
tty argument may be used to indicate the appropriate terminal. Ay 
Permission to write may be denied or granted by use of the mesg(C) 
command. At the outset, writing is allowed. Certain commands, in 
particular nroff(CT) and pr(C), disallow messages in order to 

prevent messy output. 


If the character ! is found at the beginning of a line, wmte calls the 
shell to execute the rest of the line as a command. 


The following protocol is suggested for using wnte: when you first 
write to another user, wait for him or her to write back before start- 
ing to send. Each party should end each message with a distinctive 
signal ((o) for ‘‘over’’ is conventional), indicating that the other 
may reply; (oo) for ‘‘over and out’’ is suggested when conversation 
is to be terminated. 
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Files 
/etc/utmp To find user 
/bin/sh To execute ! 


& See Also 


mail(C), mesg({C), who(C) 
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Name 
xargs — Constructs and executes commands. 

Syntax 4: 
xargs [ flags] [| command [ initial-arguments] ] 

Description 


Xargs combines the fixed tnitial-arguments with arguments read from 
the standard input to execute the specified command one or more 
times. The number of arguments read for each command invocation 
and the manner in which they are combined are determined by the 
flags specified. 


Command, which may be a shell file, is searched for using the shell 
$PATH variable. If command is omitted, /bin/echo is used. 


Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new- 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted: Characters 
enclosed in quotes (single or double) are taken literally, and the del- 
imiting quotes are removed. Outside of quoted strings a backslash 
(\) will escape the next character. 


Each argument list is constructed starting with the tnitral-arguments, 
followed by some number of arguments read from standard input 
(exception: see — i flag). Flags — i, — 1, and — n determine how 
arguments are selected for each command invocation. When none 
of these flags are coded, the tnttial-arguments are followed by argu- 
ments read continuously from standard input until an internal buffer 
is full, and then command is executed with the accumulated args. 
This process is repeated until there are no more args. When there 
are flag conflicts (e.g., — 1 vs. — nm), the last flag has precedence. 
Flag values are: 


—Inumber Command is executed for each number lines of 
nonempty arguments from the standard input. This is 
instead of the default single line of input for each com- 
mand. The last invocation of command will be with 
fewer lines of arguments if fewer than number remain. 
A line is considered to end with the first newline unless 
the last character of the line is a blank or a tab; a trail- ry 
ing blank/tab signals continuation through the next 
nonempty line. If number is omitted 1 is assumed. 
Option — x 1s forced. 


— ireplstr Insert mode: command is executed for each line from 
the standard input, taking the entire line as a single arg, 
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— nnumber 


— ss8rze 


— eeofstr 


XARGS (C) 


inserting it in tnitttal-arguments for each occurrence of 
replstr. A maximum of 5 arguments in tntttal-arguments 
may each contain one or more instances of replstr. 
Blanks and tabs at the beginning of each line are 
thrown away. Constructed arguments may not grow 
larger than 255 characters, and option — x is also 
forced. {}is assumed for replstr if not specified. 


Executes command using as many standard input argu- 
ments as possible, up to number arguments maximum. 
Fewer arguments will be used if their total size is 
greater than size characters, and for the last invocation 
if there are fewer than number arguments remaining. If 
option — x is also coded, each number arguments must 
fit in the stze limitation, else zargs terminates execu- 
tion. 


Trace mode: The command and each constructed argu- 
ment list are echoed to file descriptor 2 just prior to 
their execution. 


Prompt mode: The user is asked whether to execute 
command each invocation. Trace mode (-— t) is turned 
on to print the command instance to be executed, fol- 
lowed by a ?... prompt. A reply of y (optionally fol- 
lowed by anything) will execute the command; anything 
else, including just a carriage return, skips that particu- 
lar invocation of command. 


Causes zargs to terminate if any argument list would be 
greater than stze characters; — x is forced by the 
options — 1 and — ]. When neither of the options — i, 
— ], or — n are coded, the total length of all arguments 
must be within the size limit. 


The maximum total size of each argument list is set to 
size characters; size must be a positive integer less than 
or equal to 470. If — s is not coded, 470 is taken as the 
default. Note that the character count for size includes 
one extra character for each argument and the count of 
characters in the command name. 


Eofstr is taken as the logical end-of-file string. Under- 
score ( _) is assumed for the logical EOF string if — e is 
not coded. — e with no eofstr coded turns off the logi- 
cal EOF string capability (underscore is taken literally). 
Xargs reads standard input until either end-of-file or 
the logical EOF string is encountered. 


Xargs terminates if it either receives a return code of — 1 from, orif 
it cannot execute, command. When command is a shell program, it 
should explicitly ezit (see sh(C)) with an appropriate value to avoid 
accidentally returning with — 1. 
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Examples 


The following will move all files from directory $1 to directory $2, 
and echo each move command Just before doing it: 


ls $1 | xargs — i — t mv $1/{} $2/{} 


The following will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 


(logname; date; echo $0 $*) | xargs >>log 


The user is asked which files in the current directory are to be 
printed and prints them one at a time: 


Is | xargs — p — | Ipr 
Or many at a time: 
Is | xargs — p — | | xargs Ipr 


The following will execute diff(C) with successive pairs of arguments 
originally typed as shell arguments: 


echo $* | xargs — n2 diff 
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Name 


yes — Prints string repeatedly. 


Syntax 


yes [ string] 


Description 
Yes repeatedly outputs ‘‘y’’, or if a single string argument is given, 
then arg is output repeatedly. The command will continue 
indefinitely unless aborted. Useful in pipes to commands that 
prompt for input and require a ‘‘y’’ response for ayes. In this case, 
yes terminates when the command it pipes to terminates, so that no 
infinite loop occurs. 
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Name 


intro — Introduction to miscellaneous features and files. 


Description 


This section contains miscellaneous information useful in maintain- 
ing the system. Included are descriptions of files, devices, tables and 
programs that are important in maintaining the entire system. 
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Name 


aliases, aliases.hash, maliases, faliases - Micnet aliasing files. 


YY Description 
These files contain the alias definitions for a Micnet network. 


Aliases are short names or abbreviations that may be used in the 
mail command to refer to specific machines or users in a network. 
Aliasing allows a complex combination of site, machine, and user 
names to be represented by a single name. 


The aliases, maliases, and faliases files each define a different type 
of alias. The aliases file defines the standard aliases which are 
names for specific systems and users and, in some case, for com- 
mands. The maliases file defines machine aliases, names and paths 
for specific systems. The faliases file defines forwarding aliases 
which are temporary names for forwarding mail intended for one 
system or user to another. 


The aliases.hash file is the hashed version of the aliases file created 
by the aliashash command. The file is used by the maid command to 
resolve all standard aliases and is identical to the aliases file except 
for a hash table at the beginning of the file. The hash table allows 
for more efficient access to the entries in the file. The aliases file 
need only be present to generate the aliases.hash file. The aliases 
file is not required to run the network. 


Each file contains zero or more lines. Each line lists the alias and its 
meaning. The alias can have up to eight letters and numbers, but 
must begin with a letter. The meaning can have site, machine, and 
user login names and other aliases (its exact composition depends on 
the type of alias). A colon (:) separating the alias and meaning is 
required. 


In the aliases file, a line can have the forms: 
alias:[[site!] machine:] user[,[[site!] machine:] user]... 
alias:[[site!] machine:] command-pipeline 
alias:error-message 
Site and machine are the site and machine names of the system to 


which the user belongs or on which the specified command is to be 


— 
YY executed. The site and machine names must end with an exclama- 

tion mark (!) or colon (:), respectively, and must be defined in a 
systemid file. A machine alias may be used in place of a site and 
machine name if it is followed by a question mark. 


User is a user login name or another alias. User names in a list must 
be separated by commas. A newline may immediately follow a 
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comma. Spaces and tabs are allowed, but only immediately before or 
after a comma or newline. 


Commanda-pipeline is any valid command (with necessary arguments) 
preceded by a pipe symbol (|) and enclosed in double quotation 
marks. Spaces may separate the command and arguments, but there 
must be no space between the first double quotation mark and the 
pipe symbol. 


Error-message is any sequence of letters, numbers, and punctuation 
marks (except a double quotation mark) preceded by a number sign 
(#) and enclosed in double quotation marks. 


In the faliases file, each line can have the same form as lines in the 
aliases file except that no more than one user name can be given for 
any one alias. 


In the maliases file a line has the form: 
alias:[[site!] machine:]... 


Site and machine are the site and machine names for a specific net 
work and system. Multiple site and machine names direct messages 
along the specified path of systems. If no site or machine name is 
given, the alias is ignored. 


Before the mal program sends a message, it searches the 
aliases.hash, faliases, and maliases files to see if any of the names 
given with the command are aliases. Each file is searched in turn, 
(aliases.hash, faliases, then maliases) and if a match is found, the 
alias is replaced with its meaning. If no match is found, the name is 
assumed to be the valid login name of a user on that machine. The 
search in the aliases.hash file continues until all aliases have been 
replaced, so it is possible for several replacements to occur for a sin- 
gle name. (If a loop exists, processing continues indefinitely.) The 
faliases file is searched once, from beginning to end, even if it is 
empty. The maliases file is searched only if the alias contains a 
machine alias. 


When an alias is a user or a list of users, the mad command sends 
the message to each user in the list. When it is a command-pipeline, 
the matl command starts execution of the command on the specified 
machine and sends the message as input. When the alias is an 
error-message, the matl command ignores the message and instead 
displays the alias and its meaning at the standard error. 


In all files, any line beginning with a number sign (#) is considered 
a comment and is ignored. 


As a special feature, any alias that contains a site name as the first 
component of its meaning is automatically prepended with the 
machine alias uucp?. This alias may be explicitly defined in the 
maliases file to help direct mail between networks to the system 
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performing the uucp link. 


Files 
YY /usr/lib/mail/aliases 
/usr/lib/mail/aliases.hash 


/usr/lib/mail/maliases 


/usr/lib/mail/faliases 


See Also 


aliashash(M), netutil(C), systemid(M), top(M) 


. 
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Name 


aliashash — Micnet alias hash table generator 


Syntax 


aliashash [ -v] [ -o output-file ] [ input-file | 


Description 


The altashash command reads the tnput-fille and generates a output-file 
containing a hash table of alias definitions for a Micnet network. 
The tnput-file must name a file containing alias definitions in the 
form described for the aliases file (see altases(M)). If the — o 
option is not used to specify an output-file , the command creates a 
file with the same name as the tnput-file but with .-hash appended to 
it. If no tmput-file is given, the command reads the file named 
/usr/lib/mail /aliases and creates the file named 
/usr/lib/mail/aliases.hash. 


If invoked with the — v option, the command lists information about 
the hash table. 


The output-file will contain both the alias definitions given in the 
input-file and the new hash table. The hash table appears at the 
beginning of the file and is separated from the alias definitions by a 
blank line. The hash table has three or more lines. The first line is: 


#<hash> 


The second line has 4 entries: the bytes per table entry, the max- 
imum number of items per hash value, the number of entries in the 
table, and the offset (in bytes) from the beginning of the file to the 
beginning of the alias definitions. 


The next lines (up to the end of the hash table) contain the hash 
table entries. Each line has 8 entries (separated by spaces) and each 
entry has 2 fields. The first field (1 byte) is a checksum 
(represented as a printable character) the second field is a pointer (in 
bytes) to the alias definition. The pointer is represented as a hexade- 
cimal number with leading blanks if necessary and is always relative 
to the start of the definitions. 


the netutil command. If the alias definitions of a network must be 
changed, the definitions in the aliases file should be changed and a 
new aliases.hash file created using the altashash command. The 
new aliases.hash file must then be copied to all other computers in 
the network. 


YY The altashash command is normally invoked by the tnstall option of 
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Files 
/usr/lib/mail/aliashash 


/usr/lib/mail/aliases 


/usr/lib/mail/aliases.hash ry 


See Also 


aliases(M), netutil( C) 


Warning 
Do not use the altashash command to create the aliases.hash file 
while the network is running. If necessary, create a temporary out 
put file, aliases.hash- , using the — o option, then type: 


mv aliases.hash- aliases.hash 


This will prevent disruption of the network. 
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Name 


Ww 


ascii— Map of the ASCII character set. 


escription 


ASCII (M) 


Asctt is a map of the ASCII character set. It lists both octal and hexa- 
decimal equivalents of each character. It contains: 


|000 nul |001 
1010 bs |O11 
1020 dle j021 
[030 can |031 
1040 sp |041 
lo50 ( {051 
060 0 |061 
070 8 {071 
1100 @ {101 
ie a pee 
1120 P [121 
130 X 4131 
140 < [141 
150 bh [151 
160 p {161 
70 x (171 
| 00 nul | 01 
| 08 bs | 09 
| 10 dle| 11 
| 18 can | 19 
|} 26° ep. 7) 21 
eet i 29 
i300 ($4 
| 38 8 | 39 
| 40@ | 41 
ue Hj 
| 50 P| 51 
ep aera 
160 < | 61 
| 68 h | 69 
ete p. 2 Ti 
Lae x 24-79 
mel 'iles 
/usr/pub/ascii 
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soh |002 
ht |012 
del |022 
em |032 
}042 
}052 
}062 
|072 
|102 
}112 
}122 
}132 


“Qe KX Om PoOKr~ - 


soh 
ht 
dcl 
em 


“@2Q- eK Om pPorw~- 


stx |003 
nl {013 
de2 |023 
sub |033 
> 1043 
¢ |053 
2 |063 
|073 
|103 
|113 
|123 
1133 


NHoOONDWOuo:: 


etx |004 
vt |014 
dc3 |024 
esc |034 
# |044 
+ |054 
3  |064 
- [ote 
C |104 
K ia 
S 124 
[  |134 
c |144 
k [154 
s |164 
{ |174 
etx | 04 
vt | O¢ 
dc3 | 14 
esc | 1c 
fies 
He Sap 
ao 
wes ee 
C | 44 
KK pte 
Sp a4 
[ | Se 
c | 64 
ant ae T= 
qe: 4. Fe 
een es 


eot |005 
np |015 
dc4 |025 
fs |035 
$ |045 
}055 
1065 
|075 
[105 
|115 
\125 
1135 


—er1efaevAroAe- 


enq |006 
cr |016 
nak |026 
gs |036 
|046 
|056 
|066 
|076 
|106 
|116 
|126 
|136 


~e Be—-czEzml| a! we 


Cy. -& 
— bp 
Q 


i] 
a ad 
~ 


~e Boeo—-cgegm || o~ ! wa 


ack |007 
so |017 
syn |027 
rs |037 
|047 
1057 
|067 
|077 
1107 
}117 
|127 
}137 
\147 
|157 
|167 
|177 


07 
Of 
17 
1f 
YF | 
2f 
37 
3f 
47 


| 
| 
| 
| 
| 
| 
| 4f 
| 
| 
| 
| 
| 
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Name 


daemon.mn— Micnet mailer daemon 


Syntax 


/usr/spool/mail/daemon.mn [-ex] 


Description 


The mailer daemon performs the ‘‘backend’’ networking functions 
of the mal, rcp, and remote commands by establishing and servicing 
the serial communication link between computers in a Micnet net- 
work. 


When invoked, the daemon creates multiple copies of itself, one 
copy for each serial line used in the network. Each copy opens the 
serial line, creates a startup message for the LOG file corresponding 
to that line, and waits for a response from the daemon at the other 
end. The startup message lists the names of the machines to be con- 
nected, the serial line to be used, and the current date and time. If 
the daemon receives a correct response, it establishes the serial link 
and adds the message ‘‘first handshake complete’’ to the LOG file. 
If there is no response the daemon waits indefinitely. 


If invoked with the — x option, the daemon records each transmis- 
sion in the LOG file. A transmission entry shows the direction of the 
transmission (tx for transmit, rx for receive), the number of bytes 
transmitted, the elasped time for the transmission {in minutes and 
seconds), and the time of day of the transmission (in hours, 
minutes, and seconds). Each entry has the form: 


direction byte_count elasped_time @ _ time_of_day 


The daemon also records the date and time every hour. The date 
and time have the same format as described for the date command. 


If invoked with the — e option, the daemon records all transmission 
errors in the LOG file. An error entry shows the cause of the error 
preceded by the name of the daemon subroutine which detected the 
error. 


. The mailer daemon is normally invoked by the start option of the 
we) netutl command and is stopped by the stop option. 

During the normal course of execution, the mailer daemon uses 

several files in the /usr/spool/micnet/remote directory. These files 


provide storage for LOG entries, commands issued by the remote(C) 
command, and a list of processes under daemon control. 
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Files 
/usr/lib/mail/daemon.mn 


/usr/spool/micnet/remote/*/LOG 


/usr/spool/micnet/remote/*/mn ry 


/usr/spool/micnet/remote/local/mn* 


/usr/spool/micnet/remote /lock 


/usr/spool/micnet/remote/pids 


See Also 


netutil(C) 
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Name 


default — Default program information directory. 


Description 
The files in the directory /etc/default contain the default informa- 
tion used by system commands such as dump(C) and remote(C). 
Default information is any information required by the command 
that is not explicitly given when the command is invoked. 


The directory may contain zero or more files. Each file corresponds 
to one or more commands. A command searches a file whenever it 
has been invoked without sufficient information. Each file contains 
zero or more entries which define the default information. Each 
entry has the form: 


keyword 
or 
keyword=value 
where keyword identifies the type of information available and value 
defines its value. Both keyword and value must consist of letters, 
& digits, and punctuation. The exact spelling of a keyword and the 


appropriate values depend on the command and are described with 
the individual commands. 


Any line in a file beginning with a number sign (#) is considered a 
comment and is ignored. 


Files 
/etc/default/dump 
Jetc/default/dum pdir 
/etc/default/Ipd 
/etc/default/mkuser 
/etc/default/passwd 


YY /etc/default/quot 


/etc/default/micnet 


/etc/default/restor 
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/etc/default/su 
See Also 


remote(C), restor(C), su(C) 


dump(C), dumpdir(C), Ipr(C), mkuser(C), pwadmin(C), quot(C), oY 
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Name 


environ — The user environment. 


YY Description 
The user environment is a collection of information about a user, 


such as his login directory, mailbox, and terminal type. The environ- 
ment is stored in special ‘‘environment variables,’’? which can be 
assigned character values, such as names of files, directories, and 
terminals. These variables are automatically made available to pro- 
grams and commands invoked by the user. The commands can then 
use the values to access the user’s files and terminal. 


The following is a short list of environment variables. 


PA TH Defines the search path for the directories containing 
commands. The system searches these directories 
whenever a user types a command without giving a full 
pathname. The search path is one or more directory 
names separated by colons (:). Initially, PATH is set to 
:/bin:/usr/bin. 


HOME Names the user’s login directory. Initially, HOME is set 
to the login directory given in the user’s passwd file 
entry. 

TERM Defines the type of terminal being used. This informa- 


tion is used by commands such as more(C) which rely 
on information about the capabilities of the user’s ter- 
minal. The variable may be set to any valid terminal 
name (see terminale(M)) directly or by using the 
tset(C) command. 


TZ Defines time zone information. This information is 
used by date(C) to display the appropriate time. The 
variable may have any value of the form xxxnzzz 
where xxx is standard local time zone abbreviation, n 
is the difference in hours from GMT, and 2zz2zz is the 
daylight-saving local time zone abbreviation (if any). 
For example, EST5EDT. The difference for a location 
east of England can be given as a negative number. 


The environment can be changed by assigning a new value to a vari- 


= able. An assignment has the form 
e name=value 


For example, the assignment 
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TERM =h29 


sets the TERM variable to the value ‘‘h29’’. The new value can be 
‘‘exported’’ to each subsequent invocation of a shell by exporting 
the variable with the erport command (see sh(C)) or by using the 
env(C) command. 


A user may also add variables to the environment, but must be sure ry 
that the new names do not conflict with exported shell variables such 

as MAIL, PS1, PS2, and IFS. Placing assignments in the .profile file is 

a useful way to change the environment automatically before a ses- 

sion begins. 


Note that the environment is made available to all programs as a 
string of arrays. Each string has the form: 


name=value 
where the name is the name of an exported variable and the value is 
the variable’s current value. For programs started with a ezec(S) 
call, the environment is available through the external pointer 


environ. For other programs, individual variables in environment are 
available through getenv(S) calls. 


See Also 


env(C), login(M), sh(C), exec(S), getenv(SC), profile(M) “a 
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Name 


getty — Sets terminal mode. 


Syntax 


/etc/getty [ char | 


Description 


Getty is invoked by tnit(M) immediately after a terminal is opened 
for user logins. Getty displays a ‘‘login:’’ message, then waits for the 
user to type a login name. While reading the name, getty attempts to 
adapt the system to the speed and type of terminal being used. Once 
the name is read, getty calls login(M) with the login name as the 
argument. 


Init calls getty with a single character argument taken from the 
ttys(M) file entry for the terminal line. This argument determines 
the line speed for the terminal, and also the ‘‘login:’’ greeting mes- 
sage, which can contain control characters to initialize the terminal 
for proper communication. 


If the user types a name and terminates it with a newline (ASCII LF) 
or carriage return (ASCII CR), getty scans the name for uppercase 
alphabetic characters. If only uppercase characters are found, getty 
adapts the system to map all subsequent lowercase characters into 
the corresponding uppercase characters. Furthermore, if the name 
terminates with a carriage return character, getty sets the terminal’s 
serial line mode to CRMOD (see toctl(S)). 


If, on the other hand, the user presses the INTERRUPT key, getty 
writes the login message again. It also changes the serial line speed 
if char is 1 or 3 as described below. This allows the system to adapt 
to terminals whose line speeds vary. 


After a name has been typed and scanned, getty passes it to login(M) 
which asks for the user’s password and completes the login process. 


The following arguments from the ttys file are understood: 


— 110 baud. Intended for an ASR-33 console, for example an 
operator’s console. 


0 150 baud for an ASR-37 console. 
1 Cycles through 300-150-110-1200 baud. Useful for dialup lines. 


2 300-baud console decwriter. 


March 24, 1984 Page 1 


GETTY (M) GETTY (M) 


3 Cycles through 1200-300-150-110 baud. Recommended for 
dialup lines. 


4 2400 baud. 

5 4800 baud. 

6 $600 baud. mY 
See Also 


login(M), ioctl(S), ttys(M), init(M) 
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Name 


group — Format of the group file. 


Description 
Group contains for each group the following information: 


— Group name 


: Encrypted password (optional) 

— Numerical group ID 

— Comma-separated list of all user allowed in the group 

This is an ASCII file. The fields are separated by colons; each group 
is separated from the next by a newline. If the password field is 
null, no password is demanded. 

This file resides in directory /etc. Because of the encrypted pass- 


words, it can and does have general read permission and can be 
used, for example, to map numerical group IDs to names. 


Files 


/etc/group 


See Also 


newgrp(C), passwd(C), crypt(S), passwd(M) 
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Name 


init — Process contro! initialization. 


Syntax 


/etc /init 


Description 


The tntt program is invoked as the last step of the boot procedure 
and as the first step in enabling terminals for user logins. /nit is one 
of three programs (init, getty(M), and login(M)) used to initialize a 
system for execution. 


Init creates a process for each terminal on which a user may log in. 
It begins by opening the console device, /dev/console, for reading 
and writing. It then invokes a shell which asks for a password to 
start the system in maintenance mode. The user may type the pass- 
word or terminate the shell by typing ASCII end-of-file (CNTRL-D) at 
the console. If the shell terminates, tntt performs several steps to 
begin normal operation. It invokes a shell and reads the commands 
in the /etc/rc file. This command file performs housekeeping tasks 
such as removing temporary files, mounting file systems, and start 
ing daemons. Then init reads the file /etc/ttys and forks several 
times to create a process for each terminal device in the file. Each 
line in the /etc/ttys lists the state of the line (0 for closed, 1 for 
open), the line mode, and the serial line (see ttys(M)). Each process 
opens the appropriate serial line for reading and writing, assigning 
the file descriptors 0, 1, and 2 to the line and establishing it as the 
standard input, output, and error files. If the serial line is connected 
to a modem, the process delays opening the line until someone has 
dialed up and a carrier has been established on the line. 


Once init has opened a line, it executes the getty program, passing 
the line mode as an argument. The getty program reads the user’s 
name and invokes login(M) to complete the login process (see 
getty(M) for details). /nit waits until the user logs out by typing 
ASCII end-of-file (CNTRL-D) or by hanging up. It responds by wak- 
ing up and removing the former user’s login entry from the file 
utmp, which records current users, and makes a new entry in the file 
wtmp, which is a history of logins and logouts. Then the 
corresponding line is reopened and getty is reinvoked. 


Init has special responses to the hangup, interrupt, and quit signals. 

The hangup signal SIGHUP causes init to change the system from 
normal operation to maintenance mode. The interrupt signal SIGINT 
causes tnit to read the ttys file again to open any new lines and close 
lines that have been removed. The quit signal SIGQUIT causes init to 
disallow any further logins. In general, these signals have a 
significant effect on the system and should not be used by a naive 
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user. Instead, similar functions can be safely performed with the 
enable(C), disable(C), and shutdown(C) commands. 


Files 


/dev /tty* ‘4. 


/etc/utmp 


/usr/adm /wtmp 
/etc/ttys 
Jetc/re 


See Also 


disable(C)}, enable(C), login(M), kill(C), sh(C), shutdown(C), 
ttys(M), getty(M) 
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Name 


Id — Invokes the link editor. 


Syntax 


ld [ options] filename... 


Description 


[Ld is the XENIX link editor. It creates an executable program by 
combining one or more object files and copying the executable result 
to the file a.out. The filename must name an object or library file. 
These names must have the ‘‘.o’’ (for object) or ‘‘.a’’ (for archive 
library) extensions. If more than one name is given, the names 
must be separated by one or more spaces. If errors occur while link- 
ing, ld displays an error message; the resulting a.out file is unexecut- 
able. 


Ld concatenates the contents of the given object files in the order 
given in the command line. Library files in the command line are 
examined only if there are unresolved external references encoun- 
tered from previous object files. Library files must be in ranlib( CP) 
format, that is, the first member must be named __.SYMDFEF, 
which is a dictionary for the library. The library is searched itera- 
tively to satisfy as many references as possible and only those rou- 
tines that define unresolved external references are concatenated. 
Object and library files are processed at the point they are encoun- 
tered in the argument list, so the order of files in the command line 
is important. In general, all object files should be given before 
library files. Ld sets the entry point of the resulting program to the 
beginning of the first routine. 


There are the following options: 


— Fnum 
Sets the size of the program stack to num bytes. Default stack 
size if not given, is 2 Kbytes. 


— i Creates separate instruction and data spaces for small model 
programs. When the output file is executed, the program text 
and data areas are allocated separate physical segments. The 
text portion will be read-only and shared by all users executing 


the file. 


— Ms 
Creates small model program and checks for error, such as fixup 
overflow. This option is reserved for object files compiled or 
assembled using the small model configuration. This is the 
default model if no — M option is given. 
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— Mm 
Creates middle model program and checks for errors. This 
option is reserved for object files compiled or assembled using 
the middle model configuration. This option implies — 1. 


— Ml 
Creates a large model program and checks for errors. The 


option is reserved for object files compiled using the large model ry 


configuration. This option implies —i. 


— Oo name 
Sets the executable program filename to name instead of a.out. 


Ld should be invoked using the ec(CP) instead of invoking it 
directly. Cc invokes ld as the last step of compilation, providing all 
the necessary C-language support routines. Invoking ld directly is 


not recommended since failure to give command line arguments in 
the correct order can result in errors. 


Files 


/bin/ld 


See Also 


as(CP), ar(CP), cc( CP), ranlib( CP) a 


Notes 


The user must make sure that the most recent library versions have 
been processed with ranlib(CP) before linking. If this is not done, ld 
cannot create executable programs using these libraries. 
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Name 


login — Gives access to the system. 


& Description 
The login program is used at the beginning of each terminal session 


to identify the user attempting to log in to the system. Login is 
invoked by getty(M), after a login name has been typed in response 
to the ‘‘login:’’ message. Login prompts for the user’s password, 
then turns off echoing (where possible) to prevent the password 
from appearing on the terminal screen when typed. 


Once a password has been typed, login encrypts the password and 
compares it with the encrypted password in the user’s password entry 
(see passwd(M)). If there is a match, the login is successful. 


If password aging is in effect and the current password is out of date, 
the passwd{(C) command is automatically invoked. In this case, the 
user must change the password, then attempt to log in again. 


If the login is not completed within a certain period of time (e.g., 
one minute), login either returns control to getty, or silently discon- 
nects the dial-up line. 


After a successful login, login updates accounting files, displays a 
message about the existence of any mail, then executes the start-up 
profile file, /etc/profile, and the user’s .profile file in his home direc- 
tory. (see profile(M)). Login then initializes the user and group IDs, 
and the working directory. Finally, it executes a command inter- 
preter (usually sh(C)) according to specifications found in the 
/etc/passwd file. 


At some installations, an option may be invoked that will require a 
second ‘‘external’’ password to be entered. This will occur only for 
dial-up connections, and will be prompted by the message ‘‘External 
security:’’. Both passwords are required for a successful login. 


When the user’s shell is finally invoked, argument 0 of the com- 
mand interpreter is a dash (— ) followed by the last component of 
the interpreter’s pathname. The environment (see environ(M)) is ini- 
tialized to: 


HOME= your-login-directory 


YL PA TH =:/bin:/usr/bin 


Also, the user’s file creation mask is set to octal 022 (see 


umask(C)). 
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Files 
/etc/utmp Accounting 
/usr/adm/wtmp Accounting 


/usr/spool/mail/your-name Mailbox for user your-name 


/etc/motd Message of the day 

/etc/passwd Password file 

/etc/profile System profile 

$HOME/. profile Personal profile 
See Also 


mail(C), newgrp(C), sh(C), passwd(C) 


, su(C), umask(C), 
passwd(M), profile(M), environ(M), getty(M) 


Diagnostics 


Logtn twncorrect 
The user name or the password is incorrect. 


No shell, cannot open password file, no directory: 
Your account has not been properly set up. 


Your password has erpired. Choose a new one. 
Password aging is implemented and yours has expired. 
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Name 

makekey — Generates an encryption key. 
Syntax 

/usr/lib/makekey 
Description 


Makekey improves the usefulness of encryption schemes by increas- 
ing the amount of time required to search the key space. It reads 10 
bytes from its standard input, and writes 13 bytes on its standard 
output. The output depends on the input in a way that is intended 
to be difficult to compute (i.e., to require a substantial fraction of a 
second). 


The first 8 input bytes (the input key) can be arbitrary ASCII charac- 
ters. The last 2 input bytes (the salt) are best chosen from the set 
of digits, dot (.), slash (/), and uppercase and lowercase letters. The 
salt characters are repeated as the first 2 characters of the output. 
The remaining 11 output characters are chosen from the same set as 
the salt and constitute the output key. 


The transformation performed is essentially the following: the salt is 
used to select one of 4,096 cryptographic machines all based on the 
National Bureau of Standards DES algorithm, but broken in 4,096 
different ways. Using the input key as the key, a constant string is 
fed into the machine and recirculated. The 64 bits that come out are 
distributed into the 66 output key bits in the result. 


Makekey is intended for use with programs that perform encryption 
(e.g., ed(C) and crypt(C)). Usually its input and output will be 


pipes. 


See Also 


crypt(C), ed(C), passwd(M) 


— 
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Name 


mem, kmem — Memory image file. 


& Description 
The mem file provides access to the computer’s physical memory. 


All byte addresses in the file are interpreted as memory addresses. 
Thus, memory locations can be examined in the same way as indivi- 
dual bytes in a file. Note that accessing a nonexistent location 
causes an error. 


The kmem file is the same as mem except that it corresponds to 
kernel virtual memory rather than physical memory. 


In rare cases, the mem and kmem files may be used to write to 
memory and memory-mapped devices. Such patching is not 
intended for the naive user and may lead to a system crash if not 
conducted properly. Patching device registers is likely to lead to 
unexpected results if the device has read-only or write-only bits. 


Files 


YY /dev/mem 
/dev/kmem 
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Name 


messages — Description of system console messages. 


Description 
This section describes the various system messages which may 


appear on the system console. The messages are categorized as fol- 
lows: 


Fatal 


Recovery is impossible. 


System inconststency 
A contradictory situation exists in the kernel. 


Abnormal 
A probably legitimate but extreme situation exists. 


Hardware 
Indicates a hardware problem. 


Fatal system messages begin with ‘‘panic:’’ and indicate hardware 
problems or kernel inconsistencies that are too severe for continued 
operation. After displaying a fatal message, the system will stop. 
Rebooting is required. 


System inconsistency messages indicate problems usually traceable to 
hardware malfunction, such as memory failure. These messages 
rarely occur since associated hardware problems are_ generally 
detected before such an inconsistency can occur. 


Abnormal messages represent kernel operation problems, such as 
the overflow of critical tables. It takes extreme situations to bring 
these problems about, so they should never occur in normal system 
use. 


Hardware messages normally specify the device, dev , that caused the 
error. Each message gives a device specification of the form nn/fmm 
where nn is the major number of the device, and mm is its minor 
number. The command pipeline 

ls -1 /dev |grep nn |grep mm 


major and minor numbers. 


YY may be used to list the name of the device associated with the given 
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System Messages 


+* ABNORMAL System Shutdown *+ 
This message appears when errors occur during normal system 
shutdown. It is usually accompanied by other system mes- 
sages. System inconsistency, fatal 


bad block on dev nn/mm 
A nonexistent disk block was found on, or is being inserted in, 
the structure’s free list. System inconsistency. 


bad count on dev nn/mm 
A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 


Bad free count on dev nn/mm 
A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconstetency. 


error on dev name ( nn/mm) 
This is the way that most device driver diagnostic messages 


start. The message will indicate the specific driver and com- ‘> 


plaint. The name is a word identifying the device. 


laddress > 2°24 
This indicates an attempted reference to an illegal block 
number, one so large that it could only occur on a file system 
larger than 8 billion bytes. Abnormal. 


Inode table overflow 
Each open file requires an inode entry to be kept in memory. 
When this table overflows the specific request (usually open(S) 
or creat(S)) is refused. Although not fatal to the system, this 
event may damage the operation of various spoolers, daemons, 
the mailer, and other important utilities. Anomalous results 
and missing data files are a common result. Abnormal. 


interrupt from unknown device, vec=zzzz 
The CPU received an interrupt via a supposedly unused vector. 
This message is followed by ‘‘panic: unknown interrupt.’’ Typi- 
cally this event comes about when a hardware failure miscom- 
putes the vector of a valid interrupt. Hardware. 


no file 
There are too many open files, the system has run out of 
entries in its ‘‘open file’’ table. The warnings given for the 
message ‘‘inode table overflow’’ apply here. Abnormal. 
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no space on dev nn/mm 

This message means that the specified file system has run out 

of free blocks. Although not normally as serious, the warnings 

discussed for ‘‘inode table overflow’ apply: often programs are 

written casually and ignore the error code returned when they 

tried to write to the disk; this results in missing data and 
YY ‘fholes’’ in data files. The system administrator should keep 

close watch on the amount of free disk space and take steps to 
avoid this situation. Abnormal. 


+* Normal System Shutdown *# 
This message appears when the system has been shutdown 
properly. It indicates that the machine may now be rebooted 
or powered down. 


Out of inodes on dev nn/mm 

The indicated file system has run out of free inodes. The 
number of inodes available on a file system is determined 
when mkfse(C) is run. The default number is quite generous, 
this message should be very rare. The only recourse is to 
remove some worthless files from that file system, or dump the 
entire system to a backup device, rerun mkfa(C) with more 
inodes specified, and restore the files from backup. Abnormal. 


out of text 

When programs linked with the ld — i or — n switch are run, a 
& table entry is made so that only one copy of the pure text will 

be in memory even if there are multiple copies of the program 
running. This message appears when this table is full. The 
system refuses to run the program which caused the overflow. 
Note that there is only one entry in this table for each different 
pure text program. Multiple copies of one program will not 
require multiple table entries. Each ‘‘sticky’’ program (see 
chmod(C)) requires a permanent entry in this table; nonsticky 
pure text programs require an entry only when there is at least 
one copy being executed. Abnormal. 


panic: bad 287 int 
Attempted execution of a real mode 287 instruction. System 
tncoststency, fatal. 


panic: blkdev 
An internal disk I/O request, already verified as valid, is 
discovered to be refering to a nonexistent disk. System tncon- 
sistency, fatal. 


panic: devtab 
An internal disk I/O request, already verified as valid, is 


discovered to be refering to a nonexistent disk. System tncon- 
sistency, fatal. 


panic: linit 
The super-block of the root file system could not be read. This 
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message occurs only at boot time. Hardware, fatal. 


panic: IO err in swap 
A fatal I/O error occurred while reading or writing the swap 
area. Hardware, fatal. 


panic: memory failure - parity error 
A hardware memory failure trap has been taken. System incon- 
sistency, fatal. 


panic: memory management failure 
An error occurred during memory management operations. 
System inconsistency, fatal. 


panic: no fs 
A file system descriptor has disappeared from its table. System 
inconsistency, fatal. 


panic: no imt 
A mounted file system has disappeared from the mount table. 
System inconsistency, fatal. 


panic: no procs 

Each user is limited in the amount of simultaneous processes 
he can have; an attempt to create a new process when none is 
available or when the user’s limit is exceeded is refused. That 
is an occasional event and produces no console messages; this 
panic occurs when the kernel has certified that a free process 
table entry is available and yet can’t find one when it goes to 
get it. System inconststency, fatal. 


panic: Out of swap 
There is insufficient space on the swap disk to hold a task. The 
system refuses to create tasks when it feels there is insufficient 
disk space, but it is possible to create situations to fool this 
mechanism. Abnormal, fatal. 


panic: general protection trap 
General protection trap taken in kernel. System inconsistency, 
fatal. 


panic: segment not present 
An attempt has been made to access an invalid segment. It 
may also indicate the segment-not-present trap has been taken 
in the kernel. System inconsistency, fatal. 


panic: Timeout table overflow 
The timeout table is full. Timeout requests are generated by 
device drivers, there should usually be room for one entry per 
system serial line plus ten more for other usages. 


panic: Trap in system 
The CPU has generated an illegal instruction trap while 
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executing kernel or device driver code. This message is pre- 
ceded with an information dump describing the trap. System 
inconsistency, fatal. 


panic: Invalid TSS 
YU Internal tables have become corrupted. System inconsistency, 
fatal. 


panic: unknown interrupt 
The CPU received an interrupt via a supposedly unused vector. 
Typically this event comes about when a hardware failure 
miscomputes the vector of a valid interrupt. Hardware, fatal. 


proc on q 
The system attempts to queue a process already on the process 
ready-to-run queue. System tnconatstency, fatal. 


Trap type 
This message precedes a ‘‘panic:’’ message. The type is the 
trap number given by the processor. The message is followed 
by a dump of registers. System tnconststency, fatal. 
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Name 


micnet — The Micnet default commands file. 


Y Description 
The micnet file lists the system commands that may be executed 


through the remote command. The file is required for each system in 
a Micnet network. Whenever a remote command is received through 
the network, the Micnet programs search the micnet file for the sys- 
tem command specified with the remote command. If found, the 
command is executed. Otherwise, the command is ignored and an 
error message is returned to the system which issued the remote 
command. 


The file may contain one or more lines. If all commands may be 
executed, then only the line 


executeall 


is required in the file. Otherwise, the commands must be listed indi- 
vidually. A line that defines an individual command has the form: 


command=commandpath 


Command is the command name to be specified in a remote com- 
mand. Commandpath is the full pathname of the command on the 
specified system. The equal sign (=) separates the command and 
commandpath. For example, the line 


cat=/bin/cat 


defines the command name cat (used in the remote command) to 
refer to the system command cat in the /bin directory. 


When ezecuteall is set, commands are sought in a series of default 
directories. Initially, the directories are /bin and /usr/bin. The 
default directories can be explicitly defined in the file by including a 
line of the form: 


execpath=PA TH=directory|:directory]... 


The first part of the line, erecpath—PATH=, is required. Each direc- 
tory must be a valid pathname. The colon is required to separate 


& directories. For example, the line 
execpath=PA TH =/bin:/usr/bin:/usr/bobf/bin 


sets the default directories to /bin, /usr/bin, and /usr/bobf/bin. 
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Files 


/etc/default/micnet 


See Also 
aliases(M), netutil(C), systemid(M), top(M) ‘ry 


Notes 


The rcp command cannot be executed from a remote system unless 
the micnet file contains either ezrecuteall , or the line 


rcp=/usr/bin/rcp 
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Name 


null— The null file. 


Description 


Data written on anull special file is discarded. 


Reads from a null special file always return 0 bytes. 


Files 


/dev/null 
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Name 


passwd — The password file. 


VY Description 
Passwd contains the following information for each user: 


— Login name 


Encrypted password 


— Numerical user ID 
— Numerical group ID 


Comment 


— Initial working directory 


Program to use as shell 


This is an ASCII file. Each field within each user’s entry is separated 
from the next by a colon (:). The comment can contain any desired 
information. Each user is separated from the next by a newline. If 


the password field is null, no password is demanded; if the shell field 
is null, sh(C) is used. 


This file resides in the directory /etc. Because the passwords are 
encrypted, the file has general read permission and can be used, for 
example, to map numerical user IDs to names. 


The encrypted password consists of 13 characters chosen from a 64- 

character alphabet (., /, 0- 9, A— Z, a- z), except when the pass- 

word is null, in which case the encrypted password is also null. Pass- 

word aging is in effect for a particular user if his encrypted password 

in the password file is followed by a comma and a nonnull string of 

characters from the above alphabet. (Such a string must be intro- 

duced by the super-user.) The first character of the age denotes the 

maximum number of weeks for which a password is valid. A user 

who attempts to log in after his password has expired will be forced 

to supply a new one. The next character denotes the minimum 

period in weeks which must expire before the password may be 

changed. The remaining characters define the week (counted from 

‘ the beginning of 1970) when the password was last changed. (A null 

Ww string is equivalent to zero.) The first and second characters must 

have numerical values in the range 0— 63, where the dot (.) is equal 

to 0 and lowercase z is equal to 63. If the numerical value of both 

characters is 0, the user will be forced to change his password the 

next time he logs in. If the second character is greater than the first, 
only the super-user will be able to change the password. 
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Files 


/etc/passwd 


See Also 


login(M), passwd(C), a641(S), crypt(S), getpwent(S), group(M), -~Y 


pwadmin( C). 
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Name 


profile — Sets up an environment at login time. 


& Description 
The optional file .profile permits automatic execution of commands 


whenever a user logs in. The file is generally used to personalize a 
user’s work environment by setting exported environment variables 
and terminal mode (see environ(C)). 


When a user logs in, the user’s login shell looks for .profile in the 
login directory. If found, the shell executes the commands in the 
file before beginning the session. The commands in the file must 
have the same format as if typed at the keyboard. Any line begin- 
ning with the number sign (#) is considered a comment and is 
ignored. The following is an example of a typical file: 


# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PA TH =$PA TH:$HOME/bin 

# Make some environment variables global 

export MAIL PATH TERM 


# Set file creation mask 
umask 22 


Note that the file /etc/profile is a system-wide profile that, if it 
exists, is executed for every user before the user’s .profile is exe- 
cuted. 


Files 
$HOME/.profile 
/etc/profile 


See Also 


env(C), login(M), mail(C), sh(C), stty(C), su(C), environ(M) 
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Name 


systemid — The Micnet system identification file. 


Description 


The systemid file contains the machine and site names for a system 
in a Micnet network. A machine name identifies a system and distin- 
guishes it from other systems in the same network. A aite name 
identifies the network to which a system belongs and distinguishes 
the network from other networks in the same chain. 


The systemid file may contain a site name and up to four different 
machine names. The file has the form: 


[site-name] 
machine-namel 
[machine-name2]| 
{machine-name3] 
[machine-name4] 


The file must contain at least one machine name. The other machine 
names are optional, serving as alternate names for the same 
machine. The file must contain a site name if more than one 
machine name is given or if the network is connected to another 
through a uucp link. The site name, when given, must be on the 
first line. 


Each name can have up to eight letters and numbers but must 
always begin with a letter. There is never more than one name to a 
line. A line beginning with a pound sign (#) is considered a com- 
ment line and is ignored. 


The Micnet network requires one systemid file on each system in a 
network with each file containing a unique set of machine names. If 
the network is connected to another network through a uucp link, 
then each file in the network must contain the same site name. 


The systemid file is used primarily during resolution of aliases. 
When aliases contain site and/or machine names the name is com- 
pared with the names in the file and removed if there is a match. If 
there is no match, the alias (and associated message, file, or com- 
mand) is passed on to the specified site or machine for further pro- 


& cessing. 
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/etc/systemid 


See Also 


aliases(M), netutil(C), top(M) ry 
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Name 


termcap — Terminal capability data base. 


& Description 

The file /etc/termncap is a data base describing terminals. This data 
base is used by programs such as w1(C) and curses(S). Terminals are 
described in termcap by giving a set of capabilities and by describing 
how operations are performed. Padding requirements and initializa- 
tion sequences are included in termcap. 


Entries in termcap consist of a number of ‘:’ separated fields. The 
first entry for each terminal gives the names which are known for 
the terminal, separated by vertical bar (| ) characters. The first name 
is always 2 characters long for compatibility with older systems. The 
second name given is the most common abbreviation for the termi- 
nal, and the last name given should be a long name fully identifying 
the terminal. The second name should contain no blanks; the last 
name may well contain blanks for readability. 


Capabilities 


The following is a list of the capabilities that can be defined for a 

given terminal. In this list, (P) indicates padding may be specified, 

(P*) indicates that padding may be based on the number of lines 
affected, and uppercase names indicate XENIX extensions (except for 
CC). 


Name Type Pad? Description 


ae str (P)_ End alternate character set 

al str (P*) Add new blank line 

am bool Terminal has automatic margins 

as str (P) Start alternate character set 

be str Backspace if not “H 

BE str Bell character 

bs bool Terminal can backspace with ~H 

BS str Sent by BACKSPACE key (if not bc) 

bt str (P) Back tab 

bw bool Backspace wraps from column 0 
to last column 

CC str Command character in prototype 


if terminal settable 


cd str (P*) Clear to end of display 

ce str (P) Clear to end of line 

CF str Cursor off 

ch str (P) Like cm but horizontal motion only, 
line stays same 

CL str Sent by CHAR LEFT key 

cl str (P*) Clear screen 

cm str (P) Cursor motion 
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CN str 
co num 
CO str 
CR str 
cr str 
cs str 
CV str 
CW str 
da bool 
db bool 
dB num 
dC num 
dc str 
dF num 
DK str 
DL str 
DL str 
dl str 
dm str 
dN num 
do str 
dT num 
ed str 
EE str 
EG num 
el str 
EN str 
eo str 
ES str 
ff str 
Gl str 
G2 str 
G3 str 
G4 str 
GD str 
GE str 
GG num 
GH str 
GS str 
GU str 
GV str 
he boo! 
hd str 
HM str 
ho str 
HP str 
hu str 
hz str 
ic str 
if str 
im bool 
in bool 
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Sent by CANCEL key 
Number of columns in a line 
Cursor on 

Sent by CHAR RIGHT key 
Carriage return, (default “M) 


Change scrolling region (vt100), like cm 
Like ch but vertical only. 

Sent by CHANGE WINDOW key ‘a 
Display may be retained above 

Display may be retained below 

Number of millisec of bs delay needed 
Number of millisec of cr delay needed 
Delete character 

Number of millisec of ff delay needed 
Sent by down arrow key (if not kd) 
Sent by DELETE key 

Sent by destructive character delete key 
Delete line 

Delete mode (enter) 

Number of millisec of nl delay needed 
Down one line 

Number of millisec cf tab delay needed 
End delete mode 

Edit mode end 

Number of chars taken by ES and EE 


End insert mode; give ‘:ei=: 
if ic 
Sent by END key 


Can erase overstrikes with a blank 

Edit mode start 

Hardcopy terminal page eject (default “L) 
Upper-right (1st quadrant) corner character 
Upper-left (2nd quadrant) corner character 
Lower-left (3rd quadrant) corner character 
Lower-right (4th quadrant) corner character 
Down-tick character 

Graphics mode end 

Number of chars taken by GS and GE 
Horizontal bar character 

Graphics mode start 

Up-tick character 

Vertical bar character 

Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 

Sent by HOME key (if not kh) 


Home cursor (if no cm) 
Sent by HELP key 
Half-line up (reverse 1/2 linefeed) 


Hazeltine; can’t print ’s 

Insert character 

Name of file containing is 

Insert mode (enter); give ‘:im=:q’ if ic 
Insert mode distinguishes nulls on display 


c. 
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ip str (P*) Insert pad after character inserted 

is str Terminal initialization string 

kO-k9 str Sent by ‘other’ function keys 0-9 

kb str Sent by backspace key 

kd str Sent by terminal down arrow key 

ke str Out of ‘keypad transmit’ mode 

& KF str Key-click off 

kh str Sent by home key 

k] str Sent by terminal left arrow key 

kn num Number of ‘other’ keys 

KO str Key-click on 

ko str Termcap entries for other non-function keys 

kr str Sent by terminal right arrow key 

ks str Put terminal in ‘keypad transmit’ mode 

ku str Sent by terminal up arrow key 

10-19 str Labels on ‘other’ function keys 

LD str Sent by line delete key 

LF str Sent by line feed key 

li num Number of lines on screen or page 

LK str Sent by left arrow key (if not kl) 

ll str Last line, first column (if no cm) 

ma str Arrow key map, used by vi version 2 only 

ml bool Safe to move while in insert mode 

m1] str Memory lock on above cursor 

MN _ str Sent by minus sign key 

MP _ str Multiplan initialization string 

MR _- str Multiplan reset string 

mu str Memory unlock (turn off memory lock) 

ne bool No correctly working carriage return 
(DM2500,H2000) 

nd str Non-destructive space (cursor right) 

n| str (P*) Newline character (default \n) 

ns bool Terminal is a CRT but doesn’t scroll 

NU _ str Sent by NEXT UNLOCKED CELL key 

os bool Terminal overstrikes 

pe str Pad character (rather than null) 

PD str Sent by PAGE DOWN key 

PL str Sent by PAGE LEFT key 

PR str Sent by PAGE RIGHT key 

PS str Sent by plus sign key 

pt bool Has hardware tabs 
(may need to be set with is) 

PU str Sent by PAGE UP key 

RC str Sent by RECALC key 

RF str Sent by TOGGLE REFERENCE key 

RK _ str Sent by right arrow key (if not kr) 

YY RT str Sent by RETURN key 

RT str Sent by return key 

se str End stand out mode 

sf str (P) Scroll forwards 

Sg num Number of blank chars left by so or se 

SO str Begin stand out mode 

sT str (P) Scroll reverse (backwards) 
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ta str (P) Tab (other than ‘I or with padding) 


TB str Sent by TAB key 
tc str Entry of similar terminal - must be last 
te str String to end programs that use cm 
ti str String to begin programs that use cm 
uc str Underscore one char and move past it 
ue str End underscore mode 
ug num Number of blank chars left by us or ue 
UK - str Sent by up arrow key (if not ku) : 
ul bool Terminal underlines even though 
it doesn’t overstrike 
up str Upline (cursor up) 
us str Start underscore mode 
vb str Visible bell (may not move cursor) 
ve str Sequence to end open/visual mode 
vs str Sequence to start open/visual mode 
WL - str Sent by WORD LEFT key 
WR str Sent by WORD RIGHT key 
xb bool Beehive (fl=escape, f2=ctrl C) 
xn bool A newline is ignored after a wrap 
(Concept) 
xr bool Return acts like ce \r \n 
(Delta Data) 
XS bool Standard out not erased by writing over it 
(HP 264? ) 


xt bool Tabs are destructive, magic so char | | 
| (Teleray 1061) ry 


A Sample Entry 


The following entry describes the Concept- 100, and is among the 
more complex entries in the termcap file. (This particular concept 
entry is outdated, and is used as an example only.) 


cl |c100 Lebnve eae ee ES ee ee \ 
:al=3+\E°R:am:bs:cd=16+*\E°C:ce=16\ES:cl=2** 
:com=\Ea%+ Yt :cof#80:dc=16\E*A:d1=3*\E‘B: EON 
-eo:im =\P Pin: ip=16+*:liff24:mi:nd=\E=:\ 
:se=\Ed\Ee:so=\ED \EE:ta=8\t: ul:up=\E;:vb=\Ek\EK:xn: 


Entries may continue onto multiple lines by giving a \ as the last 
character of a line, and that empty fields may be included for reada- 
bility (here between the last field on a line and the first field on the 
next). Capabilities in termcap are of three types: Boolean capabilities 
which indicate that the terminal has some particular feature, numeric 
capabilities giving the size of the terminal or the size of particular 

delays, and string capabilities, which give a sequence which can be 

used to perform particular terminal operations. ty 


Types of Capabilities 


All capabilities have two letter codes. For instance, the fact that the 
Concept has ‘automatic margins’ (i.e. an automatic return and 
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linefeed when the end of a line is reached) is indicated by the capa- 
bility am. Hence the description of the Concept includes am. 
Numeric capabilities are followed by the character ‘#’ and then the 
value. Thus co which indicates the number of columns the terminal 
has gives the value ‘80’ for the Concept. 


\w Finally, string valued capabilities, such as ce (clear to end of line 


sequence) are given by the two character code, an ‘=’, and then a 


string ending at the next following ‘:’. A delay in milliseconds may 
appear after the ‘=’ in such a capability, and padding characters are 
supplied by the editor after the remainder of the string is sent to 
provide this delay. The delay can be either a integer, e.g. ‘20’, or an 
integer followed by an ‘*’, 1.e. ‘3%’. A ‘*’ indicates that the padding 
required is proportional to the number of lines affected by the opera- 
tion, and the amount given is the per-affected-unit padding required. 
When a ‘*’ is specified, it is sometimes useful to give a delay of the 
form ‘3.5’ specify a delay per unit to tenths of milliseconds. 


A number of escape sequences are provided in the string valued 
capabilities for easy encoding of characters there. A \E maps to an 
ESCAPE character, “x maps to a control-x for any appropriate x, and 
the sequences \n \r \t \b \f give a newline, return, tab, backspace 
and formfeed. Finally, characters may be given as three octal digits 
after a \, and the characters ~ and \ may be given as \* and \\. If it 
is necessary to place a: in a capability it must be escaped in octal as 
\072. If it is necessary to place a null character in a string capability 
it must be encoded as \200. The routines that deal with termcap use 
C strings, and strip the high bits of the output very late so that a 
\200 comes out as a \000 would. 


Preparing Descriptions 


We now outline how to prepare descriptions of terminals. The most 
effective way to prepare a terminal description is by imitating the 
description of a similar terminal in termcap and to build up a descrip- 
tion gradually, using partial descriptions with ez to check that they 
are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the termcap file to describe it or bugs in 
ez. To easily test a new terminal description you can set the environ- 
ment variable TERMCAP to a pathname of a file containing the 
description you are working on and the editor will look there rather 
than in fete/ftermcap. TERMCAP can also be set to the termcap entry 
itself to avoid reading the file when starting up the editor. 


Baste capabiities 


wv The number of columns on each line for the terminal is given by the 
co numeric capability. If the terminal is a CRT, then the number of 
lines on the screen is given by the li capability. If the terminal 

wraps around to the beginning of the next line when it reaches the 

right margin, then it should have the am capability. If the terminal 

can clear its screen, then this is given by the cl string capability. If 

the terminal can backspace, then it should have the bs capability, 


March 24, 1984 Page 5 


TERMCAP (M) TERMCAP (M) 


unless a backspace 1s accomplished by a character other than “H in 
which case you should give this character as the be string capability. 
If it overstrikes (rather than clearing a position when a character is 
struck over) then it should have the os capability. 


A very important point here is that the local cursor motions encoded 
in termcap are undefined at the left and top edges of a CRT terminal. 
The editor will never attempt to backspace around the left edge, nor 
will it attempt to go up locally off the top. The editor assumes that 
feeding off the bottom of the screen will cause the screen to scroll 
up, and the am capability tells whether the cursor sticks at the right 
edge of the screen. If the terminal has switch selectable automatic 
margins, the termcap file usually assumes that this is on, i.e. am. 


These capabilities suffice to describe hardcopy and ‘glass-tty’ termi- 
nals. Thus the model 33 teletype is described as 


t3 [33 |tty33:co#72:0s 
while the Lear Siegler ADM- 3 is described as 

cl |adm3Bflsi adm3:am:bs:cl=*Z:lift24:co #80 
Cursor addressing 


Cursor addressing in the terminal is described by a cm string capabil- 
ity, with pnntf(S) like escapes %x in it. These substitute to encod- 


ings of the current line or column position, while other characters 
are passed through unchanged. If the cm string is thought of as 
being a function, then its arguments are the line and then the 
column to which motion is desired, and the %encodings have the 
following meanings: 


Zod as in printf, 0 origin 

%2 like %2d 

% like %8d 

%, like %c 

%+x adds z to value, then %. 

%>xy if value > x adds y, no output. 

Ca reverses order of line and column, no output 

ia increments line/column (for 1 origin) 

%% gives a single % 

on exclusive or row and column with 0140 (DM2500) 
%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 


Consider the HP2645, which, to get to row 3 and column 12, needs 
to be sent \E&al2c03Y padded for 6 milliseconds. Note that the 
order of the rows and columns is inverted here, and that the row 
and column are printed as two digits. Thus its cm capability is 
‘om =6\E&%r%2c%2Y’. The Microterm ACTIV needs the current 
row and column sent preceded by a “T, with the row and column 
simply encoded in binary, ‘cm=*T%%.’. Terminals which use ‘%.’ 
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need to be able to backspace the cursor (bs or bc), and to move the 
cursor up one line on the screen (up introduced below). This is 
necessary because it is not always safe to transmit \t, \n “D and \r, 
as the system may change or discard them. 


A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus ‘cm=\E=%+ %+ ’. 


Cursor motions 


If the terminal can move the cursor one position to the right, leaving 
the character at the current position unchanged, then this sequence 
should be given as nd (non-destructive space). If it can move the 
cursor up a line on the screen in the same column, this should be 
given as up. If the terminal has no cursor addressing capability, but 
can home the cursor (to very upper left corner of screen) then this 
can be given as ho; similarly a fast way of getting to the lower left 
hand corner can be given as ll; this may involve going up with up 
from the home position, but the editor will never do this itself 
(unless 1] does) because it makes no assumption about the effect of 
moving up from the home position. 


Area clears 


If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, this should be given as ce. If the 
terminal can clear from the current position to the end of the 
display, then this should be given as cd. The editor only uses cd 
from the first column of a line. 


Insert/delete line 


If the terminal can open a new blank line before the line where the 
cursor is, this should be given as al; this is done only from the first 
position of a line. The cursor must then appear on the newly blank 
line. If the terminal can delete the line which the cursor is on, then 
this should be given as dl; this is done only from the first position 
on the line to be deleted. If the terminal can scroll the screen back- 
wards, then this can be given as sb, but just al suffices. If the termi- 
nal can retain display memory above then the da capability should be 
given; if display memory can be retained below then db should be 
given. These let the editor understand that deleting a line on the 
screen may bring non-blank lines up from below or that scrolling 
back with sb may bring down non-blank lines. 


vY Insert/delete character 
There are two basic kinds of intelligent terminals with respect to 


insert/delete character which can be described using termcap. The 
most common insert/delete character operations affect only the char- 
acters on the current line and shift characters off the end of the line. 
Other terminals, such as the Concept 100 and the Perkin Elmer Owl, 
make a distinction between typed and untyped blanks on the screen, 
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shifting upon an insert or delete only to an untyped blank on the 
screen which is either eliminated, or expanded to two untyped 
blanks. You can find out which kind of terminal you have by clear- 
ing the screen and then typing text separated by cursor motions. 
Type ‘abc def’ using local cursor motions (not spaces) between the 
‘abc’ and the ‘def’. Then position the cursor before the ‘abc’ and 
put the terminal in insert mode. If typing characters causes the rest 
of the line to shift rigidly and characters to fall off the end, then 
your terminal does not distinguish between blanks and untyped posi- 
tions. If the ‘abc’ shifts over to the ‘def’ which then move together 
around the end of the current line and onto the next as you insert, 
you have the second type of terminal, and should give the capability 
in, which stands for ‘insert null’. If your terminal does something 
different and unusual then you may have to modify the editor to get 
it to use the insert mode your terminal defines. No known terminals 
have an insert mode not falling into one of these two classes. 


The editor can handle both terminals that have an insert mode and 
terminals which send a simple sequence to open a blank position on 
the current line. Give as im the sequence to get into insert mode, 
or give it an empty value if your terminal uses a sequence to insert a 
blank position. Give as ei the sequence to leave insert mode (give 
this, with an empty value also if you gave im an empty value). Now 
give as ic any sequence needed to be sent just before sending the 
character to be inserted. Most terminals with a true insert mode will 
not give ic, terminals which send a sequence to open a screen posi- 
tion should give it here. (Insert mode is preferable to the sequence 
to open a position on the screen if your terminal has both.) If post 
insert padding is needed, give this as a number of milliseconds in ip 
(a string option). Any other sequence which may need to be sent 
after an insert of a single character may also be given in ip. 


It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g. if there is a tab after the 
insertion position). If your terminal allows motion while in insert 
mode you can give the capability mi to speed up inserting in this 
case. Omitting mi will affect only speed. Some terminals (notably 
Datamedia’s) must not have mi because of the way their insert 
mode works. 


Finally, you can specify delete mode by giving dm and ed to enter 
and exit delete mode, and dc to delete a single character while in 
delete mode. 


Highlighting, underlining, and visible bells 


If your terminal has sequences to enter and exit standout mode 
these can be given as so and se respectively. If there are several 
flavors of standout mode (such as inverse video, blinking, or under- 
lining — half bright is not usually an acceptable ‘standout’ mode 
unless the terminal is in inverse video mode constantly) the pre- 
ferred mode is inverse video by itself. If the code to change into or 
out of standout mode leaves one or even two blank spaces on the 
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screen, as the TVI 912 and Teleray 1061 do, this is acceptable, and 
although it may confuse some programs slightly, it can’t be helped. 


Codes to begin underlining and end underlining can be given as us 

and ue respectively. If the terminal has a code to underline the 

current character and move the cursor one space to the right, such 
& as the Microterm Mime, this can be given as uc. (If the underline 

code does not move the cursor to the right, give the code followed 
by a nondestructive space.) 


If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement) then this can be given as vb; it must not 
move the cursor. If the terminal should be placed in a different 
mode during open and visual modes of ez, this can be given as vs 
and ve, sent at the start and end of these modes respectively. These 
can be used to change, e.g., from a underline to a block cursor and 


back. 


If the terminal needs to be in a special mode when running a pro- 
gram that addresses the cursor, the codes to enter and exit this 
mode can be given as ti and te. This arises, for example, from ter- 
minals like the Concept with more than one page of memory. If the 
terminal has only memory relative cursor addressing and not screen 
relative cursor addressing, a one screen-sized window must be fixed 
into the terminal for cursor addressing to work properly. 


If your terminal correctly generates underlined characters (with no 
special codes needed) even though it does not overstrike, then you 
should give the capability ul. If overstrikes are erasable with a 
blank, then this should be indicated by giving eo. 


Keypad 


If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be 
set to transmit or not transmit, give these codes as ks and ke. Oth- 
erwise the keypad is assumed to always transmit. The codes sent by 
the left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as kl, kr, ku, kd, and kh respectively. If there are 
function keys such as f0, fl, ..., f{9, the codes they send can be given 
as kO, kl, ..., k9. If these keys have labels other than the default f0 
through f9, the labels can be given as 10, II, ..., 19. If there are 
other keys that transmit the same code as the terminal expects for 
= the corresponding function, such as clear screen, the termcap 2 letter 
& codes can be given in the ko capability, for example, 
‘:ko=cl,ll,sf,sb:’, which says that the terminal has clear, home down, 
scroll down, and scroll up keys that transmit the same thing as the 
cl, ll, sf, and sb entries. 


The ma entry is also used to indicate arrow keys on terminals which 
have single character arrow keys. It is obsolete but still in use in 
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version 2 of vi, which must be run on some minicomputers due to 
memory limitations. This field is redundant with kl, kr, ku, kd, and 
kh. It consists of groups of two characters. In each group, the first 
character is what an arrow key sends, the second character is the 
corresponding vi command. These commands are h for kl, j for kd, 
k for ku, | for kr, and H for kh. For example, the mime would be 
:ma=="Kj*Zk*XI1: indicating arrow keys left (“H), down (°K), up 
(“Z), and right (*X). (There is no home key on the mime.) 


Miscellaneous 


If the terminal requires other than a null (zero) character as a pad, 
then this can be given as pc. 


If tabs on the terminal require padding, or if the terminal uses a 
character other than “I to tab, then this can be given as ta. 


Hazeltine terminals, which don’t allow ‘” characters to be printed 
should indicate hz. Datamedia terminals, which echo carriage-return 
linefeed for carriage return and then ignore a following linefeed 
should indicate nc. Early Concept terminals, which ignore a linefeed 
immediately after an am wrap, should indicate xn. If an erase-eol is 
required to get rid of standout (instead of merely writing on top of 
it), xs should be given. Teleray terminals, where tabs turn all char- 
acters moved over to blanks, should indicate xt. Other specific ter- 
minal problems may be corrected by adding more capabilities of the 
form xg. 


Other capabilities include is, an initialization string for the terminal, 
and if, the name of a file containing long initialization strings. These 
strings are expected to properly clear and then set the tabs on the 
terminal, if the terminal has settable tabs. If both are given, is will 
be printed before if. This is useful where if is /fusrAibAabset/std but is 
clears the tabs first. 


Stmdar Terminals 


If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability tc 
can be given with the name of the similar terminal. This capability 
must be last and the combined length of the two entries must not 
exceed 1024. Since termltb routines search the entry from left to 
right, and since the tc capability is replaced by the corresponding 
entry, the capabilities given at the left override the ones in the simi- 
lar terminal. A capability can be cancelled with xx@ where xx is the 


capability. For example: a 
hn |2621nI:ks@ :ke@ :tc=2621: "y 


This defines a 2621nl that does not have the ks or ke capabilities, 
and hence does not turn on the function key labels when in visual 
mode. This is useful for different modes for a terminal, or for 
different user preferences. 
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Files 


/Jetc/termcap File containing terminal descriptions 


See Also 


ex(C), curses(S), termcap(S), tset(C), vi(C), more(C) 


Credit 
This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 
Ez allows only 256 characters for string capabilities, and the routines 
in termcap(S) do not check for overflow of this buffer. The total 
length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 


The ma, vs, and ve entries are specific to the vt program. 


Not all programs support all entries. There are entries that are not 
supported by any program. 


March 24, 1984 


TERMINALS (M) TERMINALS (M) 


Name 


terminals — List of supported terminals. 


& Description 
The following is a short list of terminals that may be used on a 


XENIX system. The corresponding names can be used to assign the 
terminal type to the TERM (see environ(M)). Note that additional 
terminals and names are defined in the file /usr/termcap. 


Name Terminal 
dwl DECwriter I 
dw2 DECwriter II 
h1g Heathkit h19 


h1000 Hazeltine 1000 
h1552 Hazeltine 1552 
h1500 Hazeltine 1500 
h1510 Hazeltine 1510 
h1520 Hazeltine 1520 
h2000 Hazeltine 2000 


ti700 Texas Instruments Silent 700 
ti745 Texas Instruments Silent 745 
vto0 Digital vt50 

vto0h Digital vt50h 

vto2 Digital vt52 

vtl Digital vt100 


vt100s Digital vt100 132 cols 14 lines 
vtlOOw Digital vt100 132 cols 


z19 Zenith 219 

z29 Zenith 229 
Files 

/usr/termcap 
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Name 


top, top.next— The Micnet topology files. 


YY Description 
These files contain the topology information for a Micnet network. 


The topology information describes how the individual systems in 
the network are connected and what path a message must take from 
one system to reach another. Each file contains one or more lines of 
text. Each line of text defines a connection or a communication 
path. 


The top file defines connections between systems. Each line lists the 
machine names of the connected systems, the serial lines used to 
make the connection, and the speed (baud rate) of transmission 
between the systems. Each line has the form: 


machinel ttyl machine2 tty2 speed 


machine! and machine? are the machine names of the respective sys- 
tems (as given in the systemid files). ttyf and tty? are the device 
names (e.g., tty01) of the connecting serial lines. The speed must 
be an acceptable baud rate (e.g., 110, 300, ..., 19200). 


The top.next file contains information about how to reach a particu- 
lar system from a given system. There may be several lines for each 
system in the network. Each line lists the machine name of a sys- 
tem, followed by the machine name of a system connected to it, fol- 
lowed by the machine names of all the systems that may be reached 
by going through the second system. Such a line has the form: 


machinel machine2 machine3 [machine4]... 


The machine names must be the names of the respective systems 
(as given by the first machine name in the systemid files). 


The top.nezt file must be present even if there are only two comput- 
ers in the network. In such acase, the file must be empty. 


In the top and top.next files, any line beginning with a number sign 
(#) is considered a comment and is ignored. 


YY Files 
/usr/lib/mail/top 


/usr/lib/mail/top.next 
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See Also 


aliases(M), netutil(C), systemid(M), top(M) 
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Name 


tty — General terminal interface. 


& Description 
) This section describes both a particular special file and the general 


nature of the terminal interface. 


The file /dev/tty is, in each process, a synonym for the control ter- 
minal associated with the process group of that process, if any. It is 
useful for programs or shell sequences that wish to be sure of writ- 
ing messages on the terminal no matter how output has been 
redirected. It can also be used for programs that demand the name 
of a file for output, when typed output is desired and it is tiresome 
to find out what terminal is currently in use. 


All asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this 
section discusses the common features of this interface. 


When a terminal file is opened, it normally causes the process to 
wait until a connection is established. In practice, users’ programs 
seldom open these files; they are opened by getty(M) and become a 
user’s standard input, output, and error files. The very first terminal 
file opened by the process group leader of a terminal file not already 
associated with a process group becomes the control terminal for that 
process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal 
is inherited by a child process during a fork(S). A process can break 
this association by changing its process group using setpgrp{S). 


A terminal associated with one of these files ordinarily operates in 
full-duplex mode. Characters may be typed at any time, even while 
output is occurring, and are only lost when the system’s character 
input buffers become completely full, which is rare, or when the 
user has accumulated the maximum allowed number of input char- 
acters that have not yet been read by some program. Currently, this 
limit is 256 characters. When the input limit is reached, all the 
saved characters are thrown away without notice. 


Normally, terminal input is processed in units of lines. A line is del- 
imited by a newline (ASCII LF) character, an end-of-file (ASCII EOT) 
character, or an end-of-line character. This means that a program 
attempting to read will be suspended until an entire line has been 
typed. Also, no matter how many characters are requested in the 
wy read call, at most one line will be returned. It is not, however, 
necessary to read a whole line at once; any number of characters 
may be requested in a read, even one, without losing information. 


Erase and kill processing is normally done during input. By default, 
a CNTRL-H or BACKSPACE erases the last character typed, except 


March 24, 1984 Page 1 


TTY (M) TTY (M) 


that it will not erase beyond the beginning of the line. By default, a 
CNTRL-U kills (deletes) the entire input line, and optionally outputs 
a newline character. Both these characters operate on a key-stroke 
basis, independent of any backspacing or tabbing that may have been 
done. Both the erase and kill characters may be entered literally by 
preceding them with the escape character (\). In this case the escape 
character is not read. The erase and kill characters may be changed 


(see stty(C)). 


Certain characters have special functions on input. These functions 
and their default character values are summarized as follows: 


INTR (Rubout or ASCII DEL) Generates an interrupt signal which 
is sent to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, but 
arrangements may be made either to ignore the signal or to 
receive a trap to an agreed-upon location; see eignal(S). 


QUIT (CNTRL-\ or ASCII FS) Generates a quit signal. Its treat 
ment is identical to the interrupt signal except that, unless 
a receiving process has made other arrangements, it will 
not only be terminated but a core image file (called core) 
will be created in the current working directory. 


ERASE (CNTRL-H) Erases the preceding character. It will not 


erase beyond the start of a line, as delimited by a NL, EOF, 
or EOL character. 


KILL (CNTRL-U) Deletes the entire line, as delimited by a NL, 
EOF, or EOL character. 


EOF (CNTRL-D or ASCII EOT) May be used to generate an 
end-of-file from a terminal. When received, all the charac- 
ters waiting to be read are immediately passed to the pro- 
gram, without waiting for a newline, and the EOF is dis- 
carded. Thus, if there are no characters waiting, which is 
to say the EOF occurred at the beginning of a line, zero 
characters will be passed back, which is the standard end- 
of-file indication. 


NL (ASCII LF) Is the normal line delimiter. It cannot be 
changed or escaped. 


EOL (ASCII NUL) Is an additional line delimiter, like NL. It is 
not normally used. 


STOP (CNTRL-S or ASCII DC3) Can be used to temporarily 
suspend output. It is useful with CRT terminals to prevent 
output from disappearing before it can be read. While out 
put is suspended, STOP characters are ignored and not 
read. 
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START (CNTRL-Q or ASCII DC1) Is used to resume output which 
has been suspended by a STOP character. While output is 
not suspended, START characters are ignored and not read. 
The start/stop characters cannot be changed or escaped. 


The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL 
may be changed to suit individual tastes. The ERASE, KILL, and 
EOF characters may be escaped by a preceding \ character, in which 
case no special function is carried out. 


When the carrier signal from the dataset drops, a hangup signal is 
sent to all processes that have this terminal as the control terminal. 
Unless other arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, any subse- 
quent read returns with an end-of-file indication. Thus programs 
that read a terminal and test for end-of-file can terminate appropri- 
ately when hung up on. 


When one or more characters are written, they are transmitted to the 
terminal as soon as previously-written characters have finished typ- 
ing. Input characters are echoed by putting them in the output 
queue as they arrive. If a process produces characters more rapidly 
than they can be typed, it will be suspended when its output queue 
exceeds a given limit. When the queue has drained down to the 
given threshold, the program is resumed. 


Several toctl(S) system calls apply to terminal files. The primary calls 
use the following structure, defined in the file termio.h: 


#define NCC 8 

struct termio { 
unsigned short _—_ c_iflag; /* input modes */ 
unsigned short  c_oflag; /* output modes */ 
unsigned short  c_cflag; /* control modes */ 
unsigned short _—_ c_Iflag; /* local modes */ 
char c_line; /* line discipline */ 


unsigned char c_cc[NCC]; /* control chars */ 


i 


The special control characters are defined by the array c_cc. The 
relative positions and initial values for each function are as follows: 


0 VINTR DEL 

t. Vou ats 

Z VERASE BKSP 

2 VKILL CNTRL-U, CNTRL-H, 
J 4 VEOF EOT 

5 VEOL NUL 

6 Reserved 

7 Reserved 
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IGNBRK 0000001 Ignores break condition 

BRKINT 0000002 Signals interrupt on break 

IGNPAR 0000004 Ignores characters with parity errors 
PARMRK 0000010 Marks parity errors 

INPCK 0000020 Enables input parity check ry 
ISTRIP 0000040 Strips character 

INLCR 0000100 Maps NL to CR on input 

IGNCR 0000200 Ignores CR 

ICRNL 0000400 Maps CR to NL on input 

IUCLC 0001000 Maps uppercase to lowercase on input 
IXON 0002000 Enables start/stop output control 
IXANY 0004000 Enables any character to restart output 
IXOFF 0010000 Enables start/stop input control 


If IGNBRK is set, the break condition (a character framing error with 
data all zeros) is ignored, that is, not put on the input queue and 
therefore not read by any process. Otherwise, if BRKINT is set the 
break condition will generate an interrupt signal and flush both the 
input and output queues. If IGNPAR is set, characters with other 
framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is 
not ignored is read as the 3-character sequence: 0377, 0, X, where X 
is the data of the character received in error. To avoid ambiguity in 
this case, if ISTRIP is not set, a valid character of 0377 is read as 
0377, 0377. If PARMRK is not set, a framing or parity error which is 
not ignored is read as the character NUL (0). 


If INPCK is set, input parity checking is enabled. If INPCK is not set, 
input parity checking is disabled. This allows output parity genera- 
tion without input parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7-bits, oth- 
erwise all 8-bits are processed. 


If INLCR is set, a received NL character is translated into a CR char- 
acter. If IGNCR is set, a received CR character is ignored (not read). 
Otherwise if ICRNL is set, a received CR character is translated into a 
NL character. 


If IUCLC is set, a received uppercase alphabetic character is 
translated into the corresponding lowercase character. 


If IXON is set, start/stop output control is enabled. A received STOP 
character will suspend output and a received START character will 
restart output. All start/stop characters are ignored and not read. If 
IXANY is set, any input character will restart output which has been 
suspended. 


If IXOFF is set, the system will transmit START characters when the 
input queue is nearly empty and STOP characters when nearly full. 
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The initial input control value is all bits clear. 


The c_oflag field specifies the system treatment of output: 


OPOST 0000001 Postprocesses output 
& OLCUC 0000002 Maps lowercase to uppercase on output 

ONLCR 0000004 Maps NL to CR-NL on output 
OCRNL 0000010 Maps CR to NL on output 
ONOCR 0000020 No CR output at column 0 
ONLRET 0000040 NL performs CR function 
OFILL 0000100 Uses fill characters for delay 
OFD EL 0000200 Fills is DEL, else NUL 
NLDLY 0000400 Selects newline delays: 
NLO 0 
NL1 0000400 
CRDLY 0003000 Selects carriage return delays: 
CRO 0 
CR1 0001000 
CR2 0002000 
CR3 0003000 
TABDLY 0014000 Selects horizontal tab delays: 
TABO 0 
TAB1 0004000 
TAB2 0010000 
TAB3 0014000 Expands tabs to spaces 
BSDLY 0020000 Selects backspace delays: 
BSO 0 
BS1 0020000 
VTDLY 0040000 Selects vertical tab delays: 
VTO 0 
VT1 0040000 
FFDLY 0100000 Selects form feed delays: 

: FFO 0 
FF 1 0100000 


If OPOST is set, output characters are post-processed as indicated by 
the remaining flags, otherwise characters are transmitted without 
change. 
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If OLCUC is set, a lowercase alphabetic character is transmitted as 
the corresponding uppercase character. This function is often used 
in conjunction with IUCLC. 


If ONLCR is set, the NL character is transmitted as the CR-NL charac- 
ter pair. If OCRNL is set, the CR character is transmitted as the NL 
character. If ONOCR is set, no CR character is transmitted when at 
column 0 (first position). If ONLRET is set, the NL character is 
assumed to perform the carriage return function; the column pointer 
will be set to 0 and the delays specified for CR will be used. Other- 
wise the NL character is assumed to perform the linefeed function; 
the column pointer will remain unchanged. The column pointer is 
also set to 0 if the CR character is actually transmitted. 


The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are sent to 
the terminal. In all cases a value of 0 indicates no delay. If OFILL is 
set, fill characters will be transmitted for delay instead of a timed 
delay. This is useful for high baud rate terminals which need only a 
minimal delay. If OFDEL is set, the fill character is DEL, otherwise 
NUL. 


If a form feed or vertical tab delay is specified, it lasts for about 2 
seconds. 


riage return delays are used instead of the newline delays. If OFILL 


Newline delay lasts about 0.10 seconds. If ONLRET is set, the car- 
is set, 2 fill characters will be transmitted. a 


Carriage return delay type 1 is dependent on the current column 
position, type 2 is about 0.10 seconds, and type 3 is about 0.15 
seconds. If OFILL is set, delay type 1 transmits 2 fill characters, and 
type 2 transmits 4 fill characters. 


Horizontal tab delay type 1 is dependent on the current column posi- 
tion. Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to 
be expanded into spaces. If OFILL is set, 2 fill characters will be 
transmitted for any delay. 


Backspace delay lasts about 0.05 seconds. If OFILL is set, 1 fill char- 
acter will be transmitted. 


The actual delays depend on line speed and system load. 


The initial output control value is all bits clear. 


The c_cflag field describes the hardware control of the terminal: ‘> 
CBAUD 0000017 Baud rate: 
BO 0 Hang up 
B50 0000001 50 baud 
B75 0000002 75 baud 
B110 0000003 110 baud 
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B134 0000004 134.5 baud 
B150 0000005 150 baud 
B200 0000006 200 baud 
B300 0000007 300 baud 
B600 0000010 600 baud 
B1200 0000011 1200 baud 
‘oe B1800 0000012 1800 baud 
B2400 0000013 2400 baud 
B4800 0000014 4800 baud 
B9600 0000015 9600 baud 
EXTA 0000016 External A 
EXTB 0000017 External B 
CSIZE 0000060 Character size: 
CS5 0 5 bits 
CS6 0000020 6 bits 
CS7 0000040 7 bits 
CS8 0000060 8 bits 
CSTOPB 0000100 Sends two stop bits, else one 
CREAD 0000200 Enables receiver 
PARENB 0000400 Parity enable 
PARODD 0001000 Odd parity, else even 
HUPCL 0002000 Hangs up on last close 
CLOCAL 0004000 Local line, else dial-up 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is 
used to hang up the connection. If BO is specified, the data- 
terminal-ready signal will not be asserted. Without this signal, the 
line is disconnected if connected through a modem. For any particu- 
lar hardware, impossible speed changes are ignored. 


The CSIZE bits specify the character size in bits for both transmission 
and reception. This size does not include the parity bit, if any. If 
CSTOPB is set, 2 stop bits are used, otherwise 1 stop bit. For exam- 
ple, at 110 baud, 2 stops bits are required. 


If PARENB is set, parity generation and detection is enabled and a 
parity bit is added to each character. If parity is enabled, the 
PARODD flag specifies odd parity if set, otherwise even parity is 
used. 


If CREAD is set, the receiver is enabled. Otherwise no characters 
will be received. 


If HUPCL is set, the line will be disconnected when the last process 
with the line open closes it or terminates. That is, the data- 
terminal-ready signal will not be asserted. 


If CLOCAL is set, the line is assumed to be a local, direct connection 
with no modem control. The data-terminal-ready and request-to- 
send signals are asserted, but incoming modem signals are ignored. 
If CLOCAL is not set, modem control is assumed. This means the 
data-terminal-ready and request-to-send signals are asserted. Also, 
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the carrier-detect signal must be returned before communications 
can proceed. 


The initial hardware control value after open is B9600, CS8, CREAD, 
HUPCL. 


The c_lflag field of the argument structure is used by the line discip- 
line to control terminal functions. The basic line discipline (0) pro- 


vides the following: 


ISIG 0000001 Enable signals 

ICANON 0000002 Canonical input (erase and kill processing) 
XCASE 0000004 Canonical upper/lower presentation 

ECHO 0000010 Enables echo 

ECH OE 0000020 Echoes erase character as BS-SP-BS 

ECH OK 0000040 Echoes NL after kill character 


ECH ONL 0000100 Echoes NL 
NOFLSH 0000200 Disables flush after interrupt or quit 
XCLUDE 0100000 Exclusive use of the line. 


If ISIG is set, each input character is checked against the special con- 
trol characters INTR and QUIT. If an input character matches one of 
these control characters, the function associated with that character 
is performed. If ISIG is not set, no checking is done. Thus these 
special input functions are possible only if ISIG is set. These func- 


tions may be disabled individually by changing the value of the con- 
trol character to an unlikely or impossible value (e.g. 0377). ry 


If ICANON is set, canonical processing is enabled. This enables the 
erase and kill edit functions, and the assembly of input characters 
into lines delimited by NL, EOF, and EOL. If ICANON is not set, 
read requests are satisfied directly from the input queue. A read will 
not be satisfied until at least VMIN characters have been received or 
the timeout value VTIME has expired. This allows fast bursts of 
input to be read efficiently while still allowing single character input. 
The VMIN and VTIME values are stored in the position for the EOF 
and EOL characters respectively. The time value represents tenths of 
seconds. 


If XCASE is set, and if ICANON is set, an uppercase letter is accepted 
on input by preceding it with a \ character, and is output preceded 
by a \ character. In this mode, the following escape sequences are 
generated on output and accepted on input: 


{ 
ee 
\ 
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For example, A is input as \a, \n as \\n, and \N as \\\n. 
If ECHO is set, characters are echoed as received. 


When ICANON is set, the following echo functions are possible. If 

ECHO and ECHOE are set, the erase character is echoed as ASCII BS 

SP BS, which will clear the last character from a CRT screen. If 

ECHOE is set and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be echoed after 
the kill character to emphasize that the line will be deleted. Note 
that an escape character preceding the erase or kill character removes 
any special function. If ECHONL is set, the NL character will be 
echoed even if ECHO is not set. This is useful for terminals set to 
local echo (so-called half duplex). Unless escaped, the EOF charac- 
ter is not echoed. Because EOT is the default EOF character, this 
prevents terminals that respond to EOT from hanging up. 


If NOFLSH is set, the normal flush of the input and output queues 
associated with the quit and interrupt characters will not be done. 


If XCLUDE is set, any subsequent attempt to open the tty device 
using open(S) will fail for all users except the super-user. If the call 
fails, it returns EBUSY in errno. XCLUDE is useful for programs 
which must have exclusive use of a communications line. It is not 
intended for the line to the program’s controlling terminal. XCLUDE 
must be cleared before the setting program terminates, otherwise 
subsequent attempts to open the device will fail. 


The initial line-discipline control value is all bits clear. 
The primary toctl(S) system calls have the form: 


ioctl (fildes, command, arg) 
struct termio *arg; 


The commands using this form are: 


TCGETA Gets the parameters associated with the terminal 
and stores them in the termto structure referenced 
by arg. 

TCSETA Sets the parameters associated with the terminal 


from the structure referenced by arg. The change 
is immediate. 


new parameters. This form should be used when 


i TCSETAW Waits for the output to drain before setting the 
changing parameters that will affect output. 


TCSETAF Waits for the output to drain, then flushes the 
input queue and sets the new parameters. 
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Additional toctl(S) calls have the form: 


ioctl (fildes, command, arg) 


int arg; 


The commands using this form are: 


TCSBRK 


TCXONC 


TCFLSH 


Files 
/dev /tty 
/dev/tty* 


/dev/console 


See Also 


stty(C), ioctl(S) 
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Waits for the output to drain. If arg is 0, then 
sends a break (zero bits for 0.25 seconds). 


Starts/stops control. If arg is 0, suspends output; 
if 1, restarts suspended output. 


If arg is 0, flushes the input queue; if 1, flushes 
the output queue; if 2, flushes both the input and 
output queues. 
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Name 


ttys — Login terminals file. 


Description 


The /etc/ttys file contains a list of the device special files associated 
with possible login terminals, and defines which files are to be 
opened by the tm:t(M) program on system start-up. 


The file contains one or more entries of the form 
state mode name 


The name must be the filename of a device special file. Only the 
filename may be supplied, the path is assumed to be /dev. If state is 
‘*1”’. the file is enabled for logins; if ‘‘0’’, the file is disabled. The 
mode is used as an argument to the getty(M) program. It defines 


the line speed and type of device associated with the terminal. A list 
of arguments is provided in getty(M). 

For example, the entry ‘‘16tty02’’ means the serial line tty02 is to be 
opened for logging in at 9600 baud. 


Files 


/etc/ttys 


See Also 


init(M), getty(M), enable(C), disable( C) 


Notes 


The /etc/ttys file may only be edited when the system is in system 
maintenance mode. See the XENIX Operations Guide. 
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Name 


utmp, wtmp — Formats of utmp and wtmp entries. 


WY Description 
The files utmp and wtmp hold user and accounting information for 


use by commands such as who(C), acctcon1 (see acctcon(C)), and 
login(M). They have the following structure, as defined by 
/usr/include /utmp.h: 


struct utmp 


char ut_line[8]; /* tty name */ 
char ut_name[8]; /* login name */ 
long ut_time; /* time on */ 
}; 
Files 
/etc/utmp 
/usr/adm/wtmp 
L /usr/include/utmp.h 
See Also 


acctcon(C), login(M), who(C), write(C) 
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